💡Перепроверьте ваши embedding структуры

◆ Embedding (встраивание) структур позволяет одной структуре наследовать поля и методы другой, делая их частью себя. Это может использоваться для создания новых типов данных, которые включают в себя свойства и функциональность существующих структур.

📌 Предположим, у вас есть структура:

type Person struct {
    Name    string
    Address string
    SSN     string
}

и вы хотите создать тип customer.

type Customer struct {
    Person
    ID int
}

◆ Person является embedded структурой. Все ее поля и методы встраиваются во внешнюю структуру.

◆ Приложению, которому нужен тип Customer, не интересен номер социального страхования клиента и не должен быть, но SSN неизбежно встраивается в Customer вместе с полями Name и Address.

◆ Любой код, имеющий доступ к переменной Customer, таким образом, имеет доступ и к SSN клиента.

func main() {
    p := Person{
        Name:    "John Doe",
        Address: "Doe Blvd, Doe City"
        SSN:     "123-45-6789",
    }
    c := Customer{
        Person: p,
    }
    fmt.Println(c.SSN)
}

◆ Будьте осторожны с встраиванием структур. Это очень полезная техника, но вы можете случайно открыть доступ к полям или функциям, к которым клиентский код не должен иметь доступа.

#tip

🤌DDD в Go: превозмогая трудности

DDD — сложный набор правил, который требует насмотренности. Автор рассмотрел подход, который заставит думать в рамках терминов предметной области и событий, которые там происходят. Он легко ложится на приложения с CQRS и Event Sourcing.

💬 В комментариях пишут, мол, автор тащит подходы из Java в Go. А вы как думаете?

🗺 Извлечение данных из OpenStreetMap на Go: пример использования пакета osmpbf

OpenStreetMap — некоммерческий веб-картографический проект, который может использовать каждый для извлечения и анализа данных. Например, можно узнать, сколько ресторанов суши существует в Манхэттене.

👉 Читайте на Medium или в PDF

🌟 Представлены релизы Go 1.21.5 и 1.20.12

🔐 Новый выпуск включает исправления безопасности для net/http (CVE-2023-39326), cmd/go (CVE-2023-45285) и path/filepath (CVE-2023-45283 update).

👉 Анонс

#новости

🤔 Context vs структура: следует ли передавать информацию, специфичную для запроса, через context.Context?

HTTP-обработчики могут использовать контекст для управления тайм-аутами запросов или отменой в рамках запроса. Тип Context также позволяет передавать значения (например, идентификатор пользователя, связанный с запросом) другим функциям.

❓Следует ли использовать этот механизм для передачи информации по цепочке вызовов запроса? Или лучше использовать обычную структуру?

Вот две причины, по которым использование Context для передачи значений может быть плохой идеей:

Значения в Context представляют собой пары ключ/значение, где ключ и значение являются пустыми интерфейсами (т. е. any). Другими словами, значения в контексте — это как мешок со всем подряд. Компилятор не может помочь вам отловить ошибки типов или даже проверить, есть ли информация. Удачи в устранении неполадок 😉

Если вы видите функцию, принимающую параметр Context, вы не можете сказать, что внутри. Если вы видите функцию, которая принимает параметр структуры, вы можете ясно видеть, что данные передаются, и что это за данные.

❓Но разве doSomething(ctx) не выглядит намного чище, чем doSomething(ctx, someStruct)?

Чистый код сам по себе не является целью. Код не чист только потому, что он короткий. Код чистый, если читатель может ясно видеть, что он делает.

❓Так context.WithValue() следует избегать?

Значения в контексте могут быть полезны, если они не критичны для бизнес-логики приложения. Например, совершенно нормально передавать идентификаторы запросов для логирования или измерения метрик. Читатель все равно сможет понять логику кода, и если что-то пойдет не так с этим идентификатором, это повлияет только на логирование или метрики приложения, но не на результат запроса.

💡Если данные важны для вашей бизнес-логики, не помещайте их в Context.

#tip

⚡️Свершилось: канал с книгами только по Go

Мы создали для вас канал, куда будем публиковать самые полезные книги только для Go-разработчиков. Подписывайтесь!

👉Книги для Go разработчиков

👾 Ретроспектива Ebitengine в 2023 году

Ebitengine (ранее Ebiten) — популярный движок 2D-игр для Go, который позволяет создавать игры на многочисленных платформах, включая мобильные устройства и Nintendo Switch.

Разработчик движка Hajime Hoshi празднует десятилетие проекта и рассказывает, что произошло с ним в этом году. Под катом много интересного, включая видео некоторых выпущенных игр на базе Ebitengine.

🧰 GitHub Actions CI/CD pipeline для деплоя Go-приложения: простой пример для Go-разработчика

Автор написал простейшее приложение и описал шаги по созданию пайплайна для деплоя веб-приложения на Linux-сервер. Ниже — его полный пример:

name: Golang-App-Workflow
'on':
  push:
    branches:
      - main
jobs:
  build-GoAppliation:
    runs-on: ubuntu-latest

    steps:
      
      - name: Checkout-Repository
        uses: actions/checkout@v4

      - name: Setup-Golang
        uses: actions/setup-go@v4
        with:
          go-version: '1.21'
          check-latest: true
      - run: go version

      - name: Install-Golang-Dependencies
        run: go mod download

      - name: Build-Golang-App
        run: GOOS=linux go build -o build/MusicAlbumAPI -v

      - name: Display-Build-Golang-App
        run: ls -R build/

      - name: Create-Env-File
        run: 'echo "APIKey=${{ secrets.APIKey }}" > build/.env'

      - name: Display-Env-File
        run: cat build/.env

      - name: Run-Unit-Test-Golang-App
        run: go test

      - name: Copy-Build-Golang-App
        uses: appleboy/scp-action@master
        with:
          host: '${{ secrets.VM_HOST }}'
          username: '${{ secrets.VM_USERNAME }}'
          key: '${{ secrets.VM_SSH_KEY }}'
          port: '${{ secrets.VM_SSH_PORT }}'
          source: build/
          target: /var/www/GoApplications

      - name: Deploy-Build-Golang-App-To-Ubuntu-VM
        uses: appleboy/ssh-action@master
        with:
          host: '${{ secrets.VM_HOST }}'
          username: '${{ secrets.VM_USERNAME }}'
          key: '${{ secrets.VM_SSH_KEY }}'
          port: '${{ secrets.VM_SSH_PORT }}'
          script: |
            cd /var/www/GoApplications/build
            ls -l
            sudo systemctl reload nginx
            sudo systemctl status nginx