Nibs or Xibs

• a nib, also called a xib, is very much like a storyboard expect that it only contain the design for a single item.
• NIBs and XIBs are files that describe user interfaces, and are built using interface Builder.
• A xib file is compiled into a nib file that is put into your application bundle.

Create custom table view cell on nibs

1. Add a nibs inside your project

add new file in to your project. Choose Empty from User Interface category

Click Next and Create the new file with the name you want.

2. create the view inside nibs

Step 1 : add view object by click the button library(+ button that on the right top) or also you can Press Command-shift-L for open object library as well.

and after that, drag a new Table View Cell on to the canvas.

Step 2 : Drag an image view and labels into the cell so that the cell now loogs like this:

• Position the Image View at X: 20, Y: 16, Width: 60, Height: 60
• Set The Label Text of the first label to Name, Font to System 18, X: 88, Y: 15, Width: 48, Height: 22
• Set The Label Text of the second label to Category name, Font to System 14, X: 88, Y: 45, Width: 99, Height: 17
• The Table View Cell itself needs to have a reuse identifier. You can set this in the Attributes inspector to any text that you want but in this article i’m gonna set to CustomCell

Note: Please make sure you already click on the Table View Cell

Use custom table view cell from nib in your code

1. Register nib file

• In HomeTableViewController.swift, add these lines to the end of viewDidLoad() :

The UINib class is used to load nibs. Here, you tell it to load the nib you just created. nibname: is receive nib file name, in this article my our nibs file name is CustomCell . so you can put this name into nibsname: "CustomCell" Without specify the xib file extension.

2. Create subclass for connect each ui object in nib to this

Step 1 : add new file in to your project. Choose CoCoa Touch Class from Source category

Click Next. Name it CustomTableViewCell and make it a subclass of UITableViewCell and also create XIB file should be unchecked.

Click Next and Create.

Step 2: add outlet properties to CustomTableViewCell.swift

• Open CustomCell.xib and select the Table View Cell and after that In the Identity inspector, change it’s class from UITableViewCell to CustomTableViewCell

• Hook these outlets up to the respective label and image view in the nibs

Not that this is all set up, you can tell the HomeTableViewController to use these new CustomTableViewCell.

3. Use it

• In HomeTableViewController.swift, change cellForRowAt to:

• Run the app

everything is fine, but if you scroll up to our design. above display is not the same as our design. Why ?

Set up Auto Layout Constraints

The table view cell will resize to accommodate those larger screens, but ui object inside the cell won’t to do this. You should have to add some Auto Layout Constraints to make the ui object’s.

Open CustomCell.xib and add constraints to each ui object inside cell

• Select the Image View and open the Add New Constraints Menu.

• Select the Name label and open the Add New Constraints Menu.

• Select the Category name label and open the Add New Constraints Menu.

• Run app again !

Yeahhhhhh. Finally everything is fine. That’s it 😁😊😎. see you on the next episode…

References

• UIKIT Apprentice By Ray Wenderlich
• What is Nibs ?
• What is a XIB and why would i ever use one ?
• Custom Table View Cell Github repository

Introduction

สวัสดีทุกคนที่เข้ามาด้วยนะครับ (หรืออาจจะหลงเข้ามาก็เป็นได้…). ช่วงนี้เป็นช่วงที่ผมกำลังศึกษาเกี่ยวกับ การสร้าง Simple API ของฝั่ง Backend โดยใช้ .Net Core, Entity framework, และ Postgres. วันนี้เลยอยากจะมาแชร์เกี่ยวกับขั้นตอนการทำ รวมทั้ง แหล่งเรียนรู้เพิ่มเติมหากใครสนใจ.

Web API

Initial Project

ก่อนอื่นเราจะมาสร้าง Initial Project ประเภท Web API ของเราก่อนนะฮะ ในบทความนี้ผมจะใช้ IDE ที่ชื่อว่า Rider ในการ development

1. เริ่มต้นให้เรา New Project ขึ้นมาก่อน
2. Tab ด้านซ้าย ให้เลือก ASP.NET core Web Application
3. ในส่วนของ Solution name และ Project name สามารถใส่ได้ตามต้องการเลย
4. หากเราต้องการ initial git ด้วย ก็ติ๊กถูกที่ช่อง Create Git repository ได้เลย มันจะ init ให้เราตั้งแต่เริ่ม project เลย
5. SDK ก็เลือกตามที่จะใช้เลย ในครั้งนี้ผมใช้ .Net 5 (หากใครสงสัยว่า .Net 5 คืออะไร เดี๋ยวผมจะทิ้งลิ้งไว้ท้ายบทความให้ไปอ่านเพิ่มละกันครับ)
6. Type ส่วนนี้สำคัญครับ มันเป็นเหมือนการเลือกเราจะสร้างโปรเจคในลักษณะงานแบบไหน ในบทความนี้ให้เราเลือก Web API
7. หากไม่มีการ set อะไรเพิ่มเติม ก็กดปุ่ม Create ได้เลย

Create Controller

ในส่วนนี้เราจะมาสร้าง controller กันนะครับ โดยส่วนนี้ผมมองว่าจะเป็นเหมือนด่านหน้า เมื่อมี Request จาก Client(ในที่นี้อาจจะเป็น Frontend หรือ Mobile application or etc.) เข้ามาที่ API service เรา ก็จะเจอ Controller ก่อน. โดยเราจะเลือกสร้างจาก dotnet command, สร้าง Class เองแล้วใส่รายละเอียดที่ต้องใช้ หรือ ในบทความนี้เราจะใช้ Rider เราก็สามารถ สร้าง Template ของ Web API ขึ้นมาได้ง่ายๆเลย.

1. ให้คลิกขวาที่โฟรเดอร์ Controllers จากนั้นคลิกที่ New Scaffolded Item…

2. ใส่ชื่อ Controller และ เลือก Template ที่ต้องการ ในบทความนี้เราจะเลือกใช้ API Controller — Empty

ข้อ 1: เราจะเรียกสิ่งที่เป็น […] ว่า Attribute.

ในภาพ [Route(“api/[controller]”)] หมายความว่าเรากำหนดให้ Controller จะจัดการกับ request ที่เข้ามาด้วย endpoint /api/[controller].

[controller] เป็นการที่ตัว dotnet จะหยิบเอาชื่อของ class Controller มาใส่โดยจะตัดคำว่า Controller ออก. ในตัวอย่าง [controller] คือ Todolist. ดังนั้น ถ้ามี request ที่เข้ามาด้วย endpoint api/Todolist ก็จะเข้า Class นี้.

แต่ในที่นี้เราสามารถกำหนดเองได้ตามต้องการ

Attribute ที่น่าสนใจนอกจาก Route

• สำหรับ Define HttpMethod
• สำหรับ Binding source ที่มาจาก Request เข้า model หรือ object บางอย่าง เช่น RequestBody, Query string parameter, RequestHeader

Controller 101

หลังจากก่อนหน้านี้เราสร้าง Class Controller. ในส่วนนี้เราจะมาสร้าง method เพื่อ จัดการ request แต่ละ method ที่เข้ามา.

Line 30 และ 37: จะเห็นได้ว่าเรามีการใช้ Attribute [FromBody] เพื่อ binding request body กับ Model ที่เรากำหนด ในที่นี้คือ CreateOrUpdatetodoListDto.

การสร้าง method เพื่อจัดการ request ก็เหมือนการสร้าง method ใน class ทั่วไปเลย โดย Action Return Type ของ Web API method จะแบ่งออกเป็น 3 ประเภท

• Specific type
• IActionResult
• ActionResult<T>

Specific type

หากต้องการ Return ของแค่ Type เดียว เราสามารถใช้ Action Return Type ประเภทนี้ได้ โดย Return type ก็จะเหมือนการประกาศ method ใน class ทั่วไปเลย. โดย Return Type จะเป็น Primitive type หรือ Complex type ก็ได้.

IActionResult

ใช้ในกรณีที่ต้องการ Return ของ หลาย ๆ Type(Type ในที่นี้หมายถึง Object Result จะมีอะไรบ้างนั้น เดี๋ยวผมแปะลิงค์ไว้ใต้โพส).

ActionResult<T>

Action return type ประเภทนี้จะมีความหลายกับ IActionResult แต่ต่างตรงที่ ActionResult<T> สามารถ Return ได้ระหว่าง Object Result และ Specific type.

EF Core x Postgres

หลังจากที่ก่อนหน้านี้เรา implement ในส่วน Controller กันไปแล้ว. ต่อมาเราจะมา implement ส่วนของ Repository. โดยในบทความนี้เราจะใช้ EF หรือชื่อเต็มๆคือ Entity Framework ซึ่งเป็น ORM ของฝั่ง .NET ที่นิยมมาก

โดยในส่วนนี้ผมจะมาเล่าว่า ต้องติดตั้ง Lib ตัวไหนบ้าง โดยที่เราต้องติดตั้งจะประกอบไปด้วย

• Microsoft.EntityFrameworkCore 5.0.12
• Npgsql.EntityFrameworkCore.PostgreSQL 5.0.10
• Microsoft.EntityFrameworkCore.Design 5.0.12

อย่าลืมลง Postgres กันด้วยนะฮะ จะลงในเรื่องเลยหรือจะลงใน container ก็ตามที่สะดวกเลยฮะ.

Data Model

ในส่วนนี้เราจะมาสร้าง data model กันก่อน โดย data model ก็คือ class นึงที่จะมี properties หลายๆอัน ให้นึกภาพว่า class คือ Table และ properties ก็คือ column แต่ละอัน.

• Line 3: ปกติแล้วหากเราไม่กำหนด Attribute ให้กับ Data class model ในตอน migration ชื่อ table ของเราคือชื่อ Class ที่ไม่มีคำว่า Model. แต่หากต้องการกำหนดชื่อ table เองก็สามารถกำหนด Attribute ตาม line ที่ 3 ได้เลย

ตัวอย่างหากไม่กำหนด Attribute: TodolistModel => Todolist(ชื่อ Table)

• Line 5: property ตัวนี้เปรียบเสมือน Primary key โดย
• [Column(…)] เป็น Attribute ตัวหนึ่ง ใช้เพื่อกำหนดคุณสมบัติของ column นั้นๆ เช่น กำหนด ชื่อ, data type ซึ่งหากเราไม่กำหนดชื่อให้มัน มันจะหยิบเอาชื่อ Property ไปเป็นชื่อ Column.

DbContext

ในส่วนนี้เราจะมาประกาศ สิ่งที่เรียกว่า DbContext. มันคือ class ที่เราจะเอาไว้ mapping ระหว่าง Data Model กับ Table ใน Database.

Connection String

ในส่วนนี้เราจะมากำหนด ConnectionString ที่ใช้เชื่อมต่อกับ Database ที่เราจะใช้ โดยในบทความนี้เราจะใช้ Postgres นะฮะ ถ้าใครใช้ตัวอื่นแล้วอยากดูตัวอย่างการกำหนดรูปแบบของ ConnectionString เดี๋ยวผมจะแปะลิงค์ไว้ใต้บทความ.

Register DbContext

ในส่วนนี้เราจะ register ตัว DbContext เข้ากับ App Startup เพื่อที่ว่า หากมี Class ไหนก็ตามที่ Require dependency DbContext มันก็จะ Inject เข้า Class นั้นๆให้อัตโนมัติ ถ้าผมจำไม่ผิด มันจะเรียกกระบวนการนี้ว่า IoC(inversion of control)

Line 8: คือการ get connection string จาก config

Migration

• Initial Migration With dotnet

dotnet ef migrations add InitialCreate

หากขึ้นข้อความแบบนี้ แสดงว่า initial migration เสร็จแล้ว.

• Create Table schema from migration(ที่เราทำไปขั้นตอนก่อนหน้า)

dotnet ef datebase update

หากขึ้นแบบนี้ แสดงว่า เรา migrate table ลงใน Database เรียบร้อยละ ทีนี้เราก็พร้อมจะใช้งานจริงๆละ ขั้นต่อไปเราจะเริ่มimplement ในส่วนของ repository กัน

EF Core x Postgres In Action

ในส่วนนี้เราจะเริ่ม implement repository กันนะครับ โดยในบทความนี้เราจะใช้ Repository pattern เข้ามาช่วย. Repository pattern คือการที่เราสร้าง Abstraction Layer ขึ้นมาระหว่าง ส่วนของ Business logic และ ส่วนของ Data Access layer ในมุมมองของผมที่ได้ลองกับตัวเอง ผมมองว่าวิธีนี้ทำให้เรา เขียน unit test ง่ายขึ้น

จากรูปคือการนำเอา repository pattern มาใช้. หากเราต้องการเขียน unit test เราก็แค่ mocking ตัว repository ก็คือจบละ ไม่ต้องไปยุ่งกับ Data Access layer (ในที่นี้คือ DbContext) หากใครสนใจรายละเอียดเพิ่มเติมเกี่ยวกับ Repository pattern เดี๋ยวผมแปะลิงค์ไว้ใต้บทความนะครับ

Implementing Repository

• Define abstraction layer

• Implementing

References

• https://docs.microsoft.com/en-us/aspnet/web-api/overview/web-api-routing-and-actions/attribute-routing-in-web-api-2
• https://thecodeblogger.com/2021/06/02/which-type-should-be-returned-from-net-core-web-api-actions/
• https://stackoverflow.com/questions/54336578/cant-decide-between-taskiactionresult-iactionresult-and-actionresultthing
• https://exceptionnotfound.net/asp-net-core-demystified-action-results/
• https://www.connectionstrings.com
• https://docs.microsoft.com/en-us/aspnet/mvc/overview/older-versions/getting-started-with-ef-5-using-mvc-4/implementing-the-repository-and-unit-of-work-patterns-in-an-asp-net-mvc-application
• https://docs.microsoft.com/en-us/ef/core/modeling/entity-properties?tabs=data-annotations%2Cwithout-nrt

Example Project

• https://github.com/FunnyDevP/dotnet-core-todolist
• https://github.com/FunnyDevP/csharp_book_store

Hi. Today, I would like to talk about Collection Types. The collection type is the data type for storing multiple elements in a single variable. There are several collection types in swift, but three important ones are array, dictionaries and sets.

Array

What is an array?

• It’s an ordered collection
• It’s store multiple elements of the same type
• The element in the array are zero-indexed(the index of the first element is 0)

Creating arrays

• You can create an array with array literal.

Access elements

• You can access an element in an array with subscript syntax

Slicing array with countable ranges

• You can use the subscript syntax with countable ranges to fetch more than a single value from an array.

Appending elements

If you want to add an element to the end of the array. Swift language provides 2 way for performing that, append(_:) and += operator

• append(_:)

• += operator

as the example above, if you try to append anything other than string. The compiler will show an error…

error: cannot convert value of type ‘Int’ to expected argument type ‘String’

Inserting elements

If you want to add an element into an array with a specific position, you can use the method insert(_:at:) for performing that.

The at argument defines where you want to add the element. Remember that the array is zero-indexed

Iterating element on array with for..in

as the example above, this is an iterate value from an array. if you need the index of each element, you can iterate over the return. value of the array’s enumerated() method.

Dictionaries

What is dictionaries ?

• It’s an unordered collection of pairs
• Each pair comprises a key and a value
• Keys on dictionary is unique (The same key can’t appear twice in a dictionary)

Creating dictionaries

• Using a dictionary literal
• Dictionary literal is a list of key-value pairs separated by commas and enclosed in square brackets.

When you print the dictionary, there’s no particular order to the pairs because the dictionary is unordered.

If you would like to create an empty dictionary, you can define the dictionary with [:]. Remember that, you must explicit data type, otherwise, its compiler can’t inter the type.

Accessing values

• Using subscripting syntax for access value from the dictionary.
• If the dictionary does find the key, it will return Optional type Optional(value) .
• If the dictionary doesn’t find the key, it will return nil.

Modify Dictionary

• You can using subscripting syntax for adding a new pair, update a value, and remove a pair

Adding a value

Updating values

Subscripting syntax like a upsert . upsert mean’s if does find a key on dictionary, it’s update value but if does’t find a key on dictionary, it’s adding a new pair.

Remove a pair

Iterating Pairs

• You can using for-in for iterating over a dictionary.
• The items in a dictionary are pairs, you need to use a tuple

If you would like to iterate over just the values, you can using values property and If you would like to iterate over just the keys, you can using keys property.

Sets

What is Sets ?

• It’s an unordered collection of unique value of the same type

Creating set

• You can declare a set explicitly by writing struct Set followed by the type inside angle brackets

or you can using Set([element]) without explicit type

Conclusion

Array

• Are ordered collections of values of the same type
• Use subscripting syntax => arr[index] to access and update element
• Be wary of accessing an index that’s out of bounds

Dictionaries

• Are unordered collections of key-value pairs.
• The keys and values are all of the same type
• Use subscripting syntax => arr[key] to get values, added a new pair, update value by key, and remove pair.
• The keys on dictionary is unique

Sets

• Are unordered collections of unique values of the same type

References

1. Swift Apprentice by raywenderlich Tutorial team

Optionals are Swift’s solution to the problem of representing both a value and the absence of a value nil.

Think of an optional as a box: it either contains exactly one value, or is empty. When it doesn’t contain a value, it’s said to contain nil

As the example above, You can describe that variable’s contain integer or nil

When you define a variable as an optional type, that means the value is not a real type. Like the example above, errorCode isn’t an Integer type but it’s optional of Integer. If you would like to modify that value the result is Value of optional type 'Int?' must be unwrapped to a value of type Int. So, when you would like to use a real value, you should be unwrapping that variable. the solution of unwrapping has a 4 way:

Force Unwrapping

Optional Binding

Guard

Nil coalescing

Force Unwrapping

The exclamation mark after the variable name tells the compiler that you would like to look inside the box and take out the value.

when you try to unwrap an optional variable with force unwrapping but that doesn’t contain a value, the error occurs:

Fatal error: Unexpectedly found nil while unwrapping an Optional value

How can you play it safe? You can use the if statement to check if the optional contains nil?. if it doesn’t, that means it contains a value and you can unwrap it.

Optional Binding

For this way, you don’t use exclamation marks for unwrapping value from the box.

You can define a constant variable on if statement.

• If the optional contains a value, this value is unwrapped and stored in, or bound to, the constant, and then the if statement executes the if block.

• If the optional doesn’t contain a value, then the if statement executes the else block.

Tips

it’s common practice to give the unwrapped constant the same name as the optional (shadowing that optional)

You can unwrap multiple values at the same time:

If you unwrap multiple values, It will only execute the if part of the statement when both optional contain a value.

Guard

guard statement is to check a condition and only continue executing a function if the condition is true.

The guard statement comprises guard followed by a condition that can include both Boolean expressions and optional binding, followed by else, followed by a block of code covered by the else will execute if the condition is false

Nil coalescing

You can use it when you want to get a value out of the optional no matter what and in the case of nil, you’ll use a default value.

Conclusion

1. nil represents the absence of a value
2. Non-optional variables and constants are never nil
3. Optional are like boxes that can contain a value or be empty(nil)
4. To work with the value inside an optional, you must first unwrap it from the optional.
5. The safest ways to unwrap an optional’s value is by using optional binding or nil coalescing. Use forced unwrapping only when appropriate, as it could produce a runtime error
6. You can guard let to bind an optional. If the binding fails. the compiler forces you to exist the current function

References

1. Swift Apprentice by raywenderlich Tutorial team
2. Optional in Swift: The ultimate guide
3. Difference between optional values in swift?

View Protocol

• It’s responsible for display user interface.
• It’s must implement compute property body, that’s responsible for display view on the user interface

Layout

The body property(View protocol) must return one view . If you would like to display multiple view on user interface, you can use Stack for group multiple views in one single view.

Stack

VStack

• It’s Display multiple views by vertical alignment

• By default, the views inside a Vstack are aligned to the center

HStack

• It’s Display multiple views by Horizontal alignment

By default, the view in a horizontal stack are aligned to the center and positioned with standard space in between (usually 8 points)

Spacer

The alignment options available for VStack and HStack views align the view in the opposite axis

• Vertical stack(VStack) can align the views horizontally
• Horizontal stack(HStack) can align the views vertically

1. Vertical stack(VStack)

2. Horizontal stack(HStack)

Group

The purpose of the Group is to group multiple views that applying the same modifier

below, this is an example for creating views that using the same modifier.

As the example above, you can see that multiple views are using the same modifier that Causing redundant modifiers.

You can be using Group to reduce redundant modifier

References

• SwiftUI for Masterminds by J.D Gauchat

As the content above, that’s layout fundamental. The next episode, I’m telling about State on SwiftUI. Please to be continued.

Introduction

สวัสดีครับ วันนี้จะมาแชร์ตัวอย่างการทำ integration test กับ mongodb โดยใช้ ภาษา golangและใช้ library ที่ชื่อ testcontainer-goโดยจะเป็นตัวช่วยสร้าง container เพื่อใช้สำหรับ test และเมื่อ test เสร็จ มันก็จะจัดการ remove container ให้เองเลย ทำให้ง่ายและสะดวกสบายต่อการทำ integration test

แล้วทำไมเราถึงต้องทำ integration test ด้วยละ ทำแค่ unit test อย่างเดียวพอไหม ? ส่วนตัวผมมองว่า unit test ยังไงก็ต้องมีอยู่แล้ว แต่การทำ integration test จะเป็นเหมือนการ test ของ flow นั้น ๆ ทั้งเส้น เช่น การ test http handler หรือแม้แต่การ test กับ process ที่เราต้องไปติดต่อกับ external server เช่น การ request ไปหา third-party หรือ การ query ตัว database เป็นต้น ส่วนใครที่อยากรู้เพิ่มเติมเกี่ยวกับการ testing สามารถเข้าไปอ่านได้ที่ Test Pyramid

Coding

1. initial project ด้วย go mod init {github repo}
2. install library

• mongodb : go get go.mongodb.org/mongo-driver/mongo
• testcontainer-go : go get github.com/testcontainers/testcontainers-go

ในส่วนด้านล่างนี้จะเป็น ส่วนของการเตรียมสภาพแวดล้อมสำหรับการ test

หมายเลข 1: กำหนดว่าเราจะใช้ image อะไรในการสร้าง container นั้นๆ เพื่อใช้ในการ testing

หมายเลข 2: สร้าง container จาก image ที่เรากำหนดจาก หมายเลข 1

หมายเลข 3: get host และ port เพื่อใช้ในการเชื่อมต่อกับ mongodb

หมายเลข 4: การเตรียม process clean up container

หมายเลข 5: สร้าง mongo client โดย connect ไปที่ host ของ container ที่เราสร้างไว้ก่อนหน้านี้

code แบบ เต็มๆ

// +build integration

เปรียบเสมือการ แปะว่า test ของ file นี้จะเป็น integration test นะ  จุดประสงค์คือเราต้องการจะแบ่งแยกระหว่าง unit test และ integration test

โดย คำสั่ง run test สำหรับ integration test คือ 

go test -tags=integration ./...

--------------------------------------------------------------------

// +build !integration

เปรียบเสมือการ แปะว่า test ของ file นี้จะเป็น unit test นะ

โดยคำสั่ง run test สำหรับ unit test คือ

go test ./...

*** tag build เราต้องใส่ไว้ที่ บรรทัดแรกของ file

References

1. https://golang.testcontainers.org
2. https://github.com/mongodb/mongo-go-driver

Introduction

ช่วงนี้เริ่มศึกษาเกี่ยวกับ system design โดยส่วนตัวอยากรู้ว่า หากเราจะ design ระบบสักอันนึงเนี่ย นอกจากตัว programming language แล้ว มันต้องรู้อะไรบ้างนะ เพื่อที่จะตัดสินในการเลือก tool ให้เหมาะสม กับ แอพลิเคชัน หรือ จะออกแบบระบบยังไงให้มีความทนทานในกรณีที่เกิดความเสียหาย จึงได้เริ่มต้นศึกษาจากหนังสือที่ชื่อว่า Designing Data-Intensive Applications: The Big Ideas Behind Reliable, Scalable, and Maintainable Systems ของ Martin Kleppmann ซึ่งเป็นหนังสือที่หลาย ๆ เว็บไซต์แนะนำสำหรับผู้เริ่มต้นจะศึกษาเกี่ยวกับ system design

Reliability

Reliability ก็คือ การที่ตัวระบบของเรานั้น ควร ที่จะสามารถทำงานได้อย่างถูกต้อง แม้ว่าตัวระบบของเราเจอกับความผิดพลาดบางอย่าง โดยความผิดพลาดในที่นี้ อาจจะมาจากตัว software หรือ hardware หรือจากตัวคนเราเองก็เป็นได้. โดยคุณสมบัติทั่วไปของระบบที่มีความ Reliability นั้น

• ตัวระบบสามารถทำงานได้ถูกต้องตามที่ user คาดหวังให้มันเป็น
• ตัวระบบสามารถทนทานต่อความเสียหาย (fault-tolerant) ที่อาจจะเกิดขึ้น ไม่ว่าจะจากตัว user เอง หรือเกิดจากการที่ตัว software ของเราทำงานผิดพลาด เช่น หากเกิดความผิดพลาดบางอย่างขึ้น ตัวระบบ จะยังคงทำงานต่อไปได้ ไม่ใช่. เกิดปุ๊ป ตัวระบบก็ล้มหายตายจากปั๊ป มันก็จะเร็วป๊ายยยยย
• ตัวระบบต้องสามารถป้องกันทุกการเข้าถึงโดยที่ไม่ได้รับอนุญาติ(Unauthorization) เช่น ตัวระบบไม่ควรให้ผู้ใช้เข้าถึงข้อมูลได้ หากผู้ใช้ไม่ทำการ login เข้าสู่ระบบซะก่อน

จากที่อ่านไปข้างต้น ความเสียหายมักจะมาจาก คน ไม่ก็ Hardware

Hardware Faults

ความผิดพลาดในด้าน hardware มักจะมีสาเหตุ เช่น hard disk crash. RAM เกิดความเสียหาย หรือแม้แต่ มีการหลุดของสาย network.

Human faults

หรือง่าย ๆ ก็คือเป็นความผิดพลาดที่มักจะมีสาเหตุมาจากตัวคนนั่นเอง โดยตัวอย่างเช่น จากการศึกษา ตัว internet service ที่มีขนาดใหญ่ พบว่า การ configuration ตัวระบบผิด เกิดขึ้นบ่อยมากเมื่อเทียบ ความผิดพลาดด้าน Hardware (Hardware faults) ซึ่งท่าที่พอจะมาสารถหลีกเลี่ยงความผิดก็จะมี …

• Decoupling: ในการ design ตัวระบบนั้น เราควรจะ design ให้ไม่ขึ้นตรงกับใคร หรือก็คือไม่ depend กับตัวอื่น ๆ เช่น เรามี class A และ class A Depends on Class B สิ่งที่เกิดขึ้นคือ หาก class A มีการแก้ไข class B ก็จะโดนไปด้วย ทางที่ดีเราควรออกแบบให้แต่ละตัวแยกออกจากกันไปเลย หาก แก้ไข class A ก็โดนแค่ A ส่วน class B ก็ยังคงทำงานได้เป็นปกติ
• Testing: อีกท่าที่ใช้ป้องกันความผิดพลาดที่เกิดจากคนเรา ก็คือ ต้องมีการ testing ในทุกๆ level ไม่ว่าจะเป็น unit test, integration test, หรือแม้แต่ automate test
• Monitoring: ควรมีการทำ monitoring เพื่อใช้เช็คว่า ปัญจุบันตัวระบบของเรานั้น ยังสุขภาพดี ทำงานดีเหมือนเดิมอยู่หรือเปล่า ซึ่งหากเกิดความผิดพลาดขึ้น เราจะได้รู้ตัวได้เร็ว และแก้ไขปัญหาได้อย่างรวดเร็ว

Conclusion

• Reliability ส่วนตัวผมมองว่ามันเป็นแนวคิดนึงในการออกแบบระบบ ที่ช่วยให้ตัวเราตอนออกแบบนั้น คำนึงถึงหลาย ๆ ปัจจัย ไม่ว่าจะเป็นการออกแบบให้ตัวระบบนั้นทำงานได้ถูกต้องตามที่ผู้ใช้คาดหวังให้มันเป็น หรือแม้แต่ ความสามารถในการทนทานต่อความผิดพลาดที่เกิดขึ้น(fault-tolerance) ทั้งจาก Hardware, Software หรือ Human Error แต่อย่าเข้าใจผิดคิดว่าหากเราออกแบบให้ตัวระบบของเรานั้น มีความ reliability แล้วมันจะสามารถทนทานต่อทุกความเสียหายที่เกิดขึ้น ซึ่งพูดตามความเป็นจริงคือ …. มันเป็นไปไม่ด้ายยยยย

References

1. Designing Data-Intensive Applications: The Big Ideas Behind Reliable, Scalable, and Maintainable Systems By Martin Kleppmann
2. What is Decoupling ?

Next…

ในส่วนตัวไปจะเป็นเรื่อง เกี่ยวกับ Scalability โปรดติดตามตอนต่อไป…

Message field type with Message

โดยปกติแล้ว ถ้าอยากให้ message field สามารถป้อนค่า nil ได้ เราก็แค่กำหนด type ของ message field นั้น ๆ ให้เป็น message ซะก็จบ เช่น

message M1 {
    M2 data = 1;
}

message M2 {
    string value = 1;
}

จากตัวอย่างการประกาศ message ด้านบน หมายความว่า field data ใน message M1 สามารถ มีค่าหรือไม่มีค่าก็ได้ เพราะเมื่อเราสั่ง generate protobuf แล้ว มันจะได้ struct ตามด้านล่าง

type M1 struct {
   state         protoimpl.MessageState
   sizeCache     protoimpl.SizeCache
   unknownFields protoimpl.UnknownFields

   Data *M2 `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"`
}

จากที่เห็นตาม code ด้านบน field data จะมี type เป็น *M2(Pointer of M2).

msg := M1{Data: nil}
marshaller := runtime.JSONPb{EmitDefaults: true}
b, _ := marshaller.Marshal(&msg)

Result
{"data":null}

จาก code ด้านบน ในที่สุดเราก็ได้ท่าที่ตอบโจทย์สักที เย้ๆๆๆๆๆ. แต่เดี๋ยวก่อน ในทางกลับกัน ถ้า field Data มีค่าละ json ที่ออกมามันก็ควรจะเป็น …

{“data”: “test”}

แต่ ดั๊นนนนมีเซอร์ไพรส์ซะงั้น. เพราะหลังจากที่เรากำหนดค่าให้ Data มันกลับได้ออกมาเป็น…

{“data”: {“value”: “test”}}

เอ๊…ทำไมมันถึงเป็นแบบนี้ละน๊อออออ ติ๊กต็อกๆๆ. ก็ไม่แปลกหรอก เพราะถ้าเราประกาศ message field typeให้เป็น message มันก็เหมือนเราทำ nested struct นั่นเอง. ถ้างั้นมันจะมีวิธีอื่นไหมละ ที่จะตอบโจทย์ทั้งแบบมีค่าและไม่มีค่า

Wrapper type (Well-Known Types)

จริงๆแล้ว protobuf จะมีสิ่งที่เรียกว่า Wrapper type ซึ่งจริงๆแล้วมันก็เหมือนการเอา scalar type มาห่อให้เป็น message นั่นเอง เช่น

string => google.protobuf.StringValue
int32 => google.protobuf.Int32Value
int64 => google.protobuf.Int64Value

จริงๆมีเยอะกว่านี้ อยากดูเพิ่มก็กดเข้าไปเลยยย https://developers.google.com/protocol-buffers/docs/reference/google.protobuf

จากนั้น เราก็ไปแก้ message field type data ให้เป็น wrapper type

message M1 {
    google.protobuf.String data = 1;
}
// อย่าลืม import "google/protobuf/wrappers.proto"; ด้วยยย

หลังจากที่ generate proto แล้ว ทีนี่เราจะได้ struct ที่มีหน้าตา

type M1 struct {
   state         protoimpl.MessageState
   sizeCache     protoimpl.SizeCache
   unknownFields protoimpl.UnknownFields

   Data *wrappers.StringValue `protobuf:"bytes,1,opt,name=data,proto3" json:"data,omitempty"`
}

ไหน ๆ เราก็ได้ struct โฉมใหม่ละ ไหนลองซิ มันจะได้ตามที่เราต้องการหรือเปล่า

// 1. แบบไม่มีค่า
msg := M1{Data: nil}
marshaller := runtime.JSONPb{EmitDefaults: true}
b ,_ := marshaller.Marshal(&msg)

Result
{"data":null}

// 2. แบบมีค่า
msg := M1{Data: &wrapper.StringValue{Value: "test"}}
marshaller := runtime.JSONPb{EmitDefaults: true}
b ,_ := marshaller.Marshal(&msg)

Result
{"data":"test"}

ในที่สุดดดด เราก็ได้วิธีที่ตอบโจทย์ที่สุดละ นั่นคือการประกาศตัว message field type ให้เป็นแบบ Wrapper type…..

References

https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#int32value