{"time":1610612652844,"blocks":[{"type":"Header","data":{"text":"Почему именно Go?","level":2}},{"type":"paragraph","data":{"text":"Этот язык был выбран не случайно, к этому меня подвело несколько мыслей:"}},{"type":"List","data":{"style":"ordered","items":["Go хорошо себя показывает в скорости работы, это достаточно очевидно, так как язык программирования Golang является компилируемым языком программирования, а это не может не привлекать.","Так как я программирую на Python мне проще на него перейти, чем на Java, например, синтаксис понятен, простая работа с указателями, понятная модульная струкруктура т.д. Язык я бы сказал не без сюрпризов, ну куда же без этого)","По сравнению с тем же самым Си, который я глубоко уважаю, язык Go скажем user friendly.","Не может не порадовать то, что разработка web приложений можно производить прямо из коробки, не подключая сторонних библиотек.","Ну и последнее, язык является на 2021 трендовый, пишут на нём много, он достаточно известный, поэтому я решил на нём что-нибудь пописать."]}},{"type":"Header","data":{"text":"Давайте приступим в разработке
","level":2}},{"type":"paragraph","data":{"text":"Начнём с того, какой же итог нам необходим:"}},{"type":"paragraph","data":{"text":"Это должно быть web приложение, достаточно простое, которое умеет кушать на вход URL адрес и выдавать сокращённую ссылку, Вроде бы всё просто, да, так оно и есть. Приступим к коду:"}},{"type":"paragraph","data":{"text":"Для начала нам нужно создать проект и инициализировать go mod делается это командой:"}},{"type":"Raw","data":{"html":"go mod init [ссылка на репощиторий, на котором будет хранится ваш проект]"}},{"type":"paragraph","data":{"text":"Объяснение: Как говорится всё по канонам жанра. Всё, что находится в [] (квадратных скобках) является опциональным параметром т.е. не обязательным.
"}},{"type":"paragraph","data":{"text":"Первым делом нам нужно создать сам сервер:"}},{"type":"Raw","data":{"html":"package main\n\nimport (\n\t\"log\"\n\t\"net/http\"\n)\n\nfunc main() {\n log.Fatal(http.ListenAndServe(\":8000\", nil))\n}"}},{"type":"paragraph","data":{"text":"Сразу определим его работать на порте 8000 и обернём эту функцию создания сервера в логирование."}},{"type":"paragraph","data":{"text":"Следующим этапом мы определим необходимые маршруты и сделаем функции заглушки:"}},{"type":"Raw","data":{"html":"func indexPage(w http.ResponseWriter, r *http.Request) {\n\tfmt.Fprintf(w, \"

Главная страница

\")\n}\n\nfunc redirectTo(w http.ResponseWriter, r *http.Request) {\n\tfmt.Fprintf(w, \"

Редирект на какую-то страницу

\")\n}\n\nfunc main() {\nhttp.HandleFunc(\"/\", indexPage)\nhttp.HandleFunc(\"/redirect/to/\", redirectTo)\nlog.Fatal(http.ListenAndServe(\":8000\", nil))\n}"}},{"type":"paragraph","data":{"text":"Для того, чтобы показать результат выполнения программы необходимо немного объяснить:"}},{"type":"List","data":{"style":"unordered","items":["http.ResponseWriter этот интерфейс используется обработчиком HTTP для создания HTTP ответа. (ссылка на фоициальную документацию http.ResponseWriter)","Указатель на http.Request представляет собой HTTP-запрос, полученный сервером или отправленный клиентом."]}},{"type":"paragraph","data":{"text":"Теперь можно посмотреть результат проделанной работы:"}},{"type":"Image","data":{"file":{"url":"/media/изображение_moHAXMZ.png"},"caption":"Отобразился текст \"Главная страница\" в формате заголовка первого уровня
","withBorder":false,"stretched":false,"withBackground":false}},{"type":"Image","data":{"file":{"url":"/media/изображение_SIqgJm2.png"},"caption":"Аналогичная ситуация со страницей redirect/to/
","withBorder":false,"stretched":false,"withBackground":false}},{"type":"paragraph","data":{"text":"И так, основные маршруты прописаны, теперь осталось прописать шаблон, логику и базу данных."}},{"type":"Header","data":{"text":"База данных","level":2}},{"type":"paragraph","data":{"text":"Начнём с того, что создадим базу данных:"}},{"type":"Image","data":{"file":{"url":"/media/Снимок экрана от 2021-01-14 10-11-29.png"},"caption":"","withBorder":false,"stretched":false,"withBackground":false}},{"type":"paragraph","data":{"text":"Наша база данных будет иметь простую таблицу со следующими полями:"}},{"type":"List","data":{"style":"ordered","items":["ID - уникальный идентификатор, первичный ключ (primary key)","link - поле, где мы будем хранить ссылку ну ту страницу, которую сократили","short - поле, где мы будет сохранять случайное кодовое слово, по которому мы будет идентифицировать поступающие нам запросы."]}},{"type":"paragraph","data":{"text":"База данных создана, сохранена, теперь перейдём к написанию логики на нашем мини web-приложении."}},{"type":"paragraph","data":{"text":"Нам будет необходимо написать 2 функции, которые будут отвечать за формирование строки, по которой мы будем определять ссылку и вторая функция будет отвечать за проверку правильности написания входящего адреса."}},{"type":"Raw","data":{"html":"const letterBytes = \"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ\"\n\nfunc shorting() string {\n\tb := make([]byte, 5)\n\tfor i := range b {\n\t\tb[i] = letterBytes[rand.Intn(len(letterBytes))]\n\t}\n\treturn string(b)\n}"}},{"type":"paragraph","data":{"text":"Функция shirting формирует строку из 5 символов путём получения случайного символа в строке, которая хранится в переменной letterBytes."}},{"type":"Raw","data":{"html":"func isValidUrl(token string) bool {\n\t_, err := url.ParseRequestURI(token)\n\tif err != nil {\n\t\treturn false\n\t}\n\tu, err := url.Parse(token)\n\tif err != nil || u.Host == \"\" {\n\t\treturn false\n\t}\n\treturn true\n}"}},{"type":"paragraph","data":{"text":"Функция isValidUrl проверяет, является ли введённый url корректным, путём простых проверок. "}},{"type":"paragraph","data":{"text":"Далее напишем логику для наших маршрутов, для этого нам потребуется поставить драйвер для использования базы данных Sqlite3:"}},{"type":"Raw","data":{"html":"go get github.com/mattn/go-sqlite3"}},{"type":"paragraph","data":{"text":"После чего приступим к написанию кода:
"}},{"type":"Raw","data":{"html":"func indexPage(w http.ResponseWriter, r *http.Request) {\n\ttempl, _ := template.ParseFiles(\"templates/index.html\")\n\tresult := Result{}\n\tif r.Method == \"POST\" {\n\t\tif !isValidUrl(r.FormValue(\"s\")) {\n\t\t\tfmt.Println(\"Что-то не так\")\n\t\t\tresult.Status = \"Ссылка имеет неправильный формат!\"\n\t\t\tresult.Link = \"\"\n\t\t}else{\n\t\t\tresult.Link = r.FormValue(\"s\")\n\t\t\tresult.Code = shorting()\n\t\t\tdb, err := sql.Open(\"sqlite3\", \"project.db\")\n\t\t\tif err != nil {\n\t\t\t\tpanic(err)\n\t\t\t}\n\t\t\tdefer db.Close()\n\t\t\tdb.Exec(\"insert into links (link, short) values ($1, $2)\", result.Link, result.Code)\n\t\t\tresult.Status = \"Сокращение было выполнено успешно\"\n\t\t}\n\t}\n\ttempl.Execute(w, result)\n}\n\nfunc redirectTo(w http.ResponseWriter, r *http.Request) {\n\tvar link string\n\tvars := mux.Vars(r)\n\tdb, err := sql.Open(\"sqlite3\", \"project.db\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer db.Close()\n\trows := db.QueryRow(\"select link from links where short=$1 limit 1\", vars[\"key\"])\n\trows.Scan(&link)\n\tfmt.Fprintf(w, \"\", link)\n}"}},{"type":"Header","data":{"text":"Функция indexPage","level":3}},{"type":"paragraph","data":{"text":"Функция indexPage получает шаблон, далее мы должны сформировать результат, для формирования результата напишем структуру, которая будет выглядеть таким образом:"}},{"type":"Raw","data":{"html":"type Result struct {\n\tLink string\n\tCode string\n\tStatus string\n}"}},{"type":"paragraph","data":{"text":"Структура сама по себе достаточно простая, я не буду писать какие-то большие обёртки, так как делаю это всё на коленках."}},{"type":"paragraph","data":{"text":"Поле Link отвечает за URL, который поступил на форму. Поле Code - это сформированная строка, которую мы сохраним в базе данных. Поле Status - будет заполняться в соответствии с тем, какой результат будет."}},{"type":"paragraph","data":{"text":"После проверки входящего URL в форме по методу POST, мы записываем все данные в базу данных, для начала открываем соединение с базой данных:"}},{"type":"Raw","data":{"html":"db, err := sql.Open(\"sqlite3\", \"project.db\")"}},{"type":"paragraph","data":{"text":"Далее после проверки соединения прописываем закрытие соединения, которое будет закрыто только перед саамым концом функции, так как использован оператор defer:"}},{"type":"Raw","data":{"html":"defer db.Close()"}},{"type":"paragraph","data":{"text":"После чего мы заносим в таблицу новые значения и изменяем статус на \"всё хорошо\"."}},{"type":"Raw","data":{"html":"db.Exec(\"insert into links (link, short) values ($1, $2)\", result.Link, result.Code)\nresult.Status = \"Сокращение было выполнено успешно\""}},{"type":"paragraph","data":{"text":"В конце функции мы формируем ответ, который будет выдан пользователю в виде шаблона с данными, которые мы передали.
"}},{"type":"Raw","data":{"html":"templ.Execute(w, result)"}},{"type":"paragraph","data":{"text":"Шаблон главной страницы:"}},{"type":"Raw","data":{"html":"\n\n\n \n Test Site\n\n\n{{if .Status}}\n{{.Status}}\n{{end}}\n{{if .Link}}\nСокращённая ссылка ({{.Link}}) \n{{else}}\n
\n\n
\n{{end}}\n\n"}},{"type":"paragraph","data":{"text":"Шаблон достаточно прост. Используется стандартный шаблонизатор, который поддерживает сам язык. Очень удобно!"}},{"type":"Header","data":{"text":"Функция redirectTo","level":3}},{"type":"paragraph","data":{"text":"С этой функции начинаются изменения. Для формирования url был использован пакет gorilla/mux."}},{"type":"paragraph","data":{"text":"Для того, чтобы добавить данный пакет необходимо его скачать:
"}},{"type":"Raw","data":{"html":"go get -u github.com/gorilla/mux"}},{"type":"paragraph","data":{"text":"После установки изменим наш маршрутизатор таким образом:"}},{"type":"Raw","data":{"html":"router := mux.NewRouter()\nrouter.HandleFunc(\"/\", indexPage)\nrouter.HandleFunc(\"/to/{key}\", redirectTo)\nlog.Fatal(http.ListenAndServe(\":8000\", router))"}},{"type":"paragraph","data":{"text":"Вернёмся к функции redirectTo. Эта функция принимает параметр, который находится в url адресе, это является код, по которому и идентифицируем ссылку. Для получения этого кода используется функция mux.Vars. После чего, мы также открываем соединение с базой данных и получаем в соответствии с кодом ссылку. Для получения одного значения использнуется функция QueryRow, результат которой мы записываем в переменную. В конце мы формируем ответ в виде строки, в которой прописали скрипт редиректра на указанный адрес.
"}},{"type":"Header","data":{"text":"Исходники данного примера:
","level":3}},{"type":"paragraph","data":{"text":"Bitbucket/max_geom"}},{"type":"Header","data":{"text":"Экранные формы с результатами этого web app.","level":2}},{"type":"Image","data":{"file":{"url":"/media/изображение_8ryouuq.png"},"caption":"
","withBorder":false,"stretched":false,"withBackground":false}},{"type":"Image","data":{"file":{"url":"/media/изображение_dZDDrY6.png"},"caption":"","withBorder":false,"stretched":false,"withBackground":false}}],"version":"2.18.0"}

Написания простого сервиса для сокращения ссылок на Go