「Kotlin」の記事 - Crieit

素朴な自作言語のコンパイラをKotlinに移植した

2021-01-15T05:11:53+09:00

移植一覧に戻る

Kotlin に移植してみました。やっつけなので汚いです。ライフゲームのコンパイルが通ったのでヨシ、というレベルのものです。

https://github.com/sonota88/vm2gol-v2-kotlin

移植元

ベースになっているバージョン: tag:51 のあたり

メモ

Java版からコピーしてきて修正してできあがり。3日くらい。
Kotlin は仕事で少しだけ使って、あと少し前に「標準入力を読んで行ごとに処理」と「四則演算と剰余のみのexprコマンドをKotlinで作ってみた」を書いたくらいのほぼ初心者
Java と Scala の中間みたいな印象

今回の実験は配列変数の宣言。trial ブランチで試してみました。

確認用のコードです。今回の実験ではとりあえずこれだけコンパイルできれば OK。

// declare_array.vg.txt

func main() {
  var xs[22];
}

AST がこんな感じ。お試しなので適当。

$ ( \
>   cat declare_array.vg.txt \
>   | ./run.sh tokenize \
>   | ./run.sh parse \
> ) 2>/dev/null
[
  "top_stmts",
  [
    "func",
    "main",
    [

    ],
    [
      [
        "var_array",
        "xs",
        22
      ]
    ]
  ]
]

アセンブリコードがこんな感じ。

$ ( \
>   cat declare_array.vg.txt \
>   | ./run.sh tokenize \
>   | ./run.sh parse \
>   | ./run.sh codegen \
> ) 2>/dev/null
  call main
  exit

label main
  push bp
  cp sp bp

  # 関数の処理本体
  sub_sp 22 # ... 配列のサイズ分の領域を確保する

  cp bp sp
  pop bp
  ret

これだけだったら少し修正するだけで済みました。

次のようなコードはまだ正しく動くようにコンパイルできません。

func main() {
  var xs[22];
  var a = 11;
}

配列がスタック上で占有している幅を考慮しないといけないのに、それをまだやってないからです。これをやろうとするとたぶんあちこち修正しないといけなくなるので、それはまた今度ということで。

Flutterのネイティブで重い処理をさせる方法（Android）

2020-05-09T14:43:35+09:00

Flutterを使ってAndroidのネイティブで重い処理をさせているとおかしくなることがあった。具体的にはFutureBuilderを使っている時に気づいたのだが、いつまでたってもFutureBuilderが完了状態にならない。

そういえば以前から下記のようなログが出ていることを思い出した。

Skipped 229 frames! The application may be doing too much work on its main thread

これはメインスレッドでの処理が重すぎるから途中でやめちゃったよ、というAndroid側のメッセージ。ということで、この処理を別スレッドで実行してあげる必要がある。例えば元々下記のような処理を行っているとする。

if (call.method == "heavy") {
    myInstance.heavyAction()
    result.success(true)
}

上記を別スレッドにする必要がある。あまりここに色々詰め込みたくなかったのでメソッド内に記述した。

fun heavyAction(callback: () -> Unit) {
    thread {
        heavy()
        callback()
    }
}

呼び出し側

if (call.method == "heavy") {
    myInstance.heavyAction() {
        result.success(true)
    }
}

これで良さそうに思うのだが、今度は下記のエラーが出る。

Methods marked with @UiThread must be executed on the main thread

完了処理を別スレッドで行わず、メインUIスレッドで行なえ、とのこと。

ということで最終的に呼び出し元は下記のようになった。

if (call.method == "heavy") {
    myInstance.heavyAction() {
        runOnUiThread {
            result.success(true)
        }
    }
}

単一プロパティを持つdata classをJSONのプリミティブ型として表現する

2020-04-12T16:25:35+09:00

Value Objectとして使っている、単一プロパティを持つdata classを、シンプルなJSONとして表現するのにちょっと手こずったのでまとめておきます。

問題設定

例として、次のようなクラス定義を考えます。

data class User(val userId: UserId, val userName: UserName)
data class UserId(val value: Int)
data class UserName(val value: String)

UserオブジェクトをJacksonでシリアライズした場合、普通だと次のようになります。

{"userId": {"value": 1}, "userName": {"value": "sato"}}

これを次のようにシリアライズした上で、元の形にデシリアライズしたいというのが、この記事の主題です。

{"userId": 1, "userName": "sato"}

なお、 UserId や UserName は User 以外のクラスからも使われる可能性があります。これらを使うクラス間で挙動を統一できるよう、クラス定義に手を加えるなら User よりも UserId や UserName に加えたいです。

結論

次のように、 UserId や UserName にアノテーション @JsonCreator と @JsonValue をつけると実現できます。

data class User(val userId: UserId, val userName: UserName)
data class UserId @JsonCreator(mode = JsonCreator.Mode.DELEGATING) constructor(@JsonValue val value: Int)
data class UserName @JsonCreator(mode = JsonCreator.Mode.DELEGATING) constructor(@JsonValue val value: String)

解説

まず、 @JsonValue はシリアライズに影響を与えるアノテーションで、シリアライズ結果を取得するメソッドに付けます。

次に、 @JsonCreator はデシリアライズに影響を与えるアノテーションで、JSONの値からオブジェクトを作るためのコンストラクターやファクトリーメソッドに付けます。Javaの場合はコンストラクターに @JsonCreator をつけるだけでいいのですが、Kotlin Moduleを使っている場合はうまく行かないので、 mode = JsonCreator.Mode.DELEGATING が必要です [1]。

なお、Kotlinでプライマリコンストラクターにアノテーションをつけるには、 constructor キーワードが必要です [2]。

コード

実際のコードは次のようになります。

build.gradleの一部

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8"
    implementation "com.fasterxml.jackson.core:jackson-databind:2.9.10.4"
    implementation "com.fasterxml.jackson.module:jackson-module-kotlin:2.9.10"
}

Main.kt

import com.fasterxml.jackson.annotation.JsonCreator
import com.fasterxml.jackson.annotation.JsonValue
import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
import com.fasterxml.jackson.module.kotlin.readValue

fun main() {
    val u = User(UserId(1), UserName("sato"))
    println(u)

    val mapper = jacksonObjectMapper()
    val json = mapper.writeValueAsString(u)
    println(json)

    val parsed: User = mapper.readValue(json)
    println(parsed)
}

data class User(val userId: UserId, val userName: UserName)
data class UserId @JsonCreator(mode = JsonCreator.Mode.DELEGATING) constructor(@JsonValue val value: Int)
data class UserName @JsonCreator(mode = JsonCreator.Mode.DELEGATING) constructor(@JsonValue val value: String)

実行結果

User(userId=UserId(value=1), userName=UserName(value=sato))
{"userId":1,"userName":"sato"}
User(userId=UserId(value=1), userName=UserName(value=sato))

参考

java - How to instruct Jackson to serialize a field inside an Object instead of the Object it self? - Stack Overflow
https://stackoverflow.com/questions/11031110/how-to-instruct-jackson-to-serialize-a-field-inside-an-object-instead-of-the-object-it-self
java - Is there a generic way to deserialize single-valued value objects (without custom Deserializer) in Jackson - Stack Overflow
https://stackoverflow.com/questions/55492657/is-there-a-generic-way-to-deserialize-single-valued-value-objects-without-custo

注釈

[1] @jsonCreator on primary constructor is not working · Issue #305 · FasterXML/jackson-module-kotlin
https://github.com/FasterXML/jackson-module-kotlin/issues/305
[2] https://kotlinlang.org/docs/reference/annotations.html#usage

八丈島のホテルで、運用費用０円の伝票システムアプリ作って、業務改善した話。

2019-06-24T16:00:38+09:00

QIitaと同じ投稿です！
Qiitaで読みたいという方はこちら

このたび東京都八丈島のホテル、リードパーク＆リゾート八丈島で伝票システムアプリを作らせてもらいました！

このシステムアプリの全機能はブログの記事で動画を交えて説明しています。
（QiitaじゃTwitter経由でしかアップできないため）

全機能説明ページはこちら

謝辞

ホテルの皆様

今回自分がこんな貴重な機会を得られ、最後まで作ることができたのは、寛容で柔軟なホテル支配人・レストランリーダー・スタッフの皆様のお陰だと本当に思います。

最初は遅延もあったり、レシート２枚出てきたりしてましたが、毎日使用後に多くのフィードバックを得られたので開発がとても捗りました。
「楽しい！」「今までで１番使いやすい」などの声は本当に嬉しいです:laughing:

Firebase(Google)さん

ありがとうFirebaseとGoogleさん!!!
お陰でサーバーレス・運用費０円で開発できました。
今度 Pixel 3a 買います

作ったもの　　---動画---

投稿用　注文① pic.twitter.com/diXsgs4DQX
— 山本燿司 (@baske0806) 2019年5月29日

作ったもの　　---図---

👆この拙い図で表しきれてませんが、僕が作った業務アプリは、

スタッフが客席で注文をタブレットで入力 → DBに記入
バーカウンターの端末(Fire HD10)がDBの変更を瞬時にリッスン、DBからデータを取って、Bluetooth経由でプリンターに送信　→ レシート印刷

というものです。
これをAndroid 上でKotlin & Firebase Realtime Databaseでつくりました。
（技術や機械の選定理由は後ほど）

ちょっと自己紹介

自分は1998年生まれで、神戸大学の経済学部に通っていて現在は休学中です。（戻らないと思う。）
もともと文系でプログラミングとは無縁でしたが、半年ほど前に Kotlin のチュートリアル本から学び始めて今に至ります。Kotlin大好き。
次は Flutter & Firebase でなにか作って公開しようとおもいます。

この後は東京に行ってどこかで働きたいと思ってます！
（ご縁があればよろしくお願いします:raising_hand_tone1:）

このアプリを作ることになった経緯

もともとこのホテルのレストランで住み込みバイトで働いていて、空いた時間に個人開発でアプリを作ろうと思ってました。

ホテルのレストラン: 公式ホームページより

このホテルは最大200名様分の客席があり、レストランは

全１４９席
個室宴会場（４０席）　ある大きいレストランです。

ここで働いているうちに色々な改善点があるなと思うようになってきました。
その内の一つ（かつ最大）が、 ドリンクの注文 → 席に運ぶ までの流れと、伝票計算の処理です。

レストランの業務は開店・閉店作業を除くと主に、以下の作業です。

お客様を席まで案内　→　最初のドリンク注文をとる

* 各お客様のペースに合わせて食事配膳（和食のコース料理で、約７種類）&空いた皿を下げる
* ドリンクの追加注文を受けるたび、作業中断でドリンクを作り、持っていく。

この①、③のドリンク作業がネックでした。

従来はドリンクの注文の度、

このように、１人のスタッフが一連の作業を全て行っていました。
夕食の時間帯は３つあって(18時~/18時30分~/19時~)、それぞれの時間帯で約20～50名ほどが一気に来られます。スタッフは１席ごとの注文で１往復するので、最初のドリンクを早く捌かないとその後の全ての作業が遅れてしまいます。
追加注文の際も、作業が中断されるので効率が落ちてしまいます。

そしてお客が全員帰ると、各伝票に各ドリンクの単価を記入して、電卓で合計を計算、記入していました。（多いときは100人分ほど）

この作業をなくしたいと思い、試作品を作って、支配人・ホテルリーダーに見せると即決で「試してみよう」となり、開発が決まりました！

導入後の作業フロー

各スタッフが端末(Fire 7)をポケットに入れ、バーカウンターに通信用の端末１台と、サーマルプリンター１台を置いています。

注文を受けるスタッフは、バーカウンターに行く必要はなく、注文入力後、次の席に行ってまた注文を受けられます。
バーカウンターのスタッフは次々と印刷されるレシートを見て、ドリンクを作り、お盆にレシートと一緒にドリンクを置いていきます。
そして手の空いているスタッフが、そのお盆を持ち、レシートに記されている席まで運びます。(レシートはどんどん重ねて挟んでいく。)

このように、作業の分業化ができるようになりました！！
さらに単価もレシートに記載されていおり、最後に１枚１枚伝票を計算する必要もなくなりました！

使用した技術・機器の選定理由

ハード面

Why Fire7 ？

自分がここのホテルに来る前、他の伝票サービスを導入する試みがあったらしく、もともとFire 7 はありました。（結局導入には至らなかったそうです。）
それに、ホテルのソムリエエプロンのポッケに丁度フィットします:v:

Why（サーマルプリンター） StarPrnt TSP650||？

スター精密は安心できるし、SDKもしっかりしていて、尚且つ安価なのが決めてでした。（4万円弱）
このモデルはBluetooth通信に対応していて、印刷速度も１番早かったのでこれに決めました。

ソフト面

Why Android？

もともとFire端末があり、自分もAndridを学び始めたばっかだったから。
（Fire OSは、独自といってますがほぼAndroid。）
この偶然はラッキーでした。

Why Kotlin?

自分が学び始めたのがKotlinからだったから。
（Javaと100%相互互換なので結果的にJavaも段々わかってきた。）

Why Firebase？

最初はAWSかAzureと思っていたのですが、Firebaseは無料枠（しかも大容量）があり、それにDBの性能が最高でこれだけで十分だったからです。(とくにリアルタイム同期とオフライン処理)
Firebaseの無料枠が、AWS（Amazon）・Azure（Microsoft）との競争の中で勝つための策だとしたらAWS, Azureにも感謝です。

👇１００名ほどのディナー１日で、この容量なので、まだまだまだ余裕があります。

Why Firebase RealtimeDB？

これは、FireStoreと悩んだのですが結局RealtimeDBにしました。理由は、

Realtime DBは Key-Valueなので、高速。
FireStoreの特徴の強力なクエリは必要なかった。
~~ベータ版なのでちょっと気が引ける。~~

でしたが、よく考えるとお客130人前後の注文情報なんて500Bぐらいで済むので、遅延とかはそこまで変わらないと思います。

それに最近知ったのですが、FireStoreの方はGoogleのインフラをフル活用していて、今後GoogleはFirestore推しでいくらしいです。
~~ですが、β版というのが気になりました。~~

次の個人開発からはFirestoreを使います。

※追記
@chronicle さんのご指摘で、見落としに気付きました。ありがとうございます！
Firestoreは現在正規版で、GCPのサービス品質保証契約（SLA）も適用されてます！どんどん使いましょう！

課題解決

ここからは、開発の過程でつまづいた所、その解決策を書いていきます。

レシート１枚で全ての情報を表す。

分業化するにあたって、注文を受ける人・ドリンクを作る人・運ぶ人はレシート１枚を通して情報伝達を行う必要があります。必要な情報は、
ドリンクを作るのに

ドリンク名（もしくは商品名）
その飲み方（お湯割りやロックなど）
あればオプション（「常温で」、「レモンつけて」など）

テーブルまで運ぶのに

テーブル番号

会計用に

そのテーブルの全注文履歴と合計金額
各ドリンク（商品）の単価
お部屋番号（会計は部屋付けなので）

以上の情報を１枚のレシートに入れなければなりません。
最初はStarPrntのSDKを使えば、なんか良い感じに自動で割り振ってくれると思ってました（希望的観測）。

が、実際は自分でテンプレートを作ったり、行数・フォントサイズを調整する必要がありました。

これはこれでめっちゃ楽しかったです。まず普段のレシートに目が行くようになって、「あ～これ手抜いてるな」とか「すげぇ！どうやって！？」みたいに思うところが増えました。

コードを貼るとめちゃ長くなるので、別記事でレシートの作り方はまとめます。

※追記※書きました！
【誰得】普段目にする、レシート印刷の実装方法

少し言うと、縦横を揃えるためにすべての文字を全角にして、計算して空白を適切な数入れたり、１行に収められるようにしたりしました。👇
（半角のサイズは全角の半分でないため、混ざっているとややこしい。）


   var order = Transliterator.getInstance("Halfwidth-Fullwidth").transliterate(orderList[x])

   if (order.count() >= 18){
         order = order.substring(0, 18)
    }

   val size = order.count()
   val rest = 22 - size
   data = (order + "　".repeat(rest - 3) + qList[x] + "\n")

超はしょって、試行錯誤の末こうすることで解決しました。

以下の点に気を付けました。

お客様にとって重要な情報は大きく太く（ここはお客様の年齢層も高く、見やすいレイアウトを心がけた）
お客にとって重要でない情報（日時、作り方、端末番号）は、小さく明記
注文ごとをブロックで分け、どの注文を作れば良いのか、わかるようにした。（常に１番下のブロックのドリンクを作る）

これで、お客は何を頼んで合計は何円かわかるし、ドリンクを作る人も何をどのように作るのか、運ぶ人もどこに運ぶのかを一目でわかるようになりました！

注文ごとをブロックで分けるにはDBの設計を見直す必要がありました。
DB設計で気をつけたことは後述しますが、これは柔軟なNoSQLモデルだからこそ簡単にできたのだと思います。

プリンターの排他制御

これはめちゃくちゃ悩みました。まず、排他制御自体を知らなかったので探そうにもGoogleは教えてくれず、、、だったのですがMENTAというサービスでメンターの方に相談するとすぐに解決しました。

Kotlin(Java)ではとっても簡単で、

@Syncronized
fun a (){
//処理
}

👆このように関数の上に @Syncronizedを入力するだけで排他制御が実装できます。

あとはコードの設計を見直して、排他制御を実装した関数内で
DBからデータの読み取り → レシート情報作り → 印刷 → 初期化
の処理を行うようにします。
１３台同時に注文してもきちんと印刷されました:relaxed:

DBの設計

Firebase RealtimeDBでは、リレイショナルなモデルではなく、データをJSONツリー型で保持するNoSQLモデルです。

自分はリレイショナルなDBをほとんど触ったことがなかったので、逆に変な違和感とかはなかったです。
このモデルで大事なことは２つで、

余計なデータまで読み込まないように、深くネストしない
効率よく必要なデータを見つけるための、平坦化(非正規化）

です。さらにこのアプリでは、DB設計を考えるにあたって

各注文ごとをブロックで分ける（理由は上記）
簡単にレシート印刷できるようにする

という事を考えながら設計し、以下のようにしました👇！
（１１番テーブルの注文のみ）

RealtimeDBでは、最大３４回ネストできるのですが、ここでは５回に抑えることができました。

そしてどのデータもテーブル番号 (Table Number) （画像では　TN 11）と紐づけることで、注文２回目以降は、テーブル番号入力後、すぐにメニュー画面へ遷移でき、途中でデータの削除や数量変更などもできます。

また、一番上の"Checker"ノードを作ることで、、効率的にレシートを印刷できます。
色々なクラスからレシートを印刷する必要があるのですが（注文履歴変更後や、確認用など）、それも以下のコードで実装できます。👇


val table = "11" //実際のコードでは、この値をintentで渡している。

//実際には、トランザクション処理
val mDatabase = Firebase.getInstance().getReference("Checker")
mDatabase.child("TN $table").child("check").setValue(false)
mDatabase.child("TN $table").child("check").setValue(true)

それに、プリンター横の端末は、"Checker"ノードにリスナーを設置し、"check"の値がfalse → trueになるのを監視するだけでいいので、こうしています👇

 val check: Boolean = p0.child("check").value.toString().toBoolean()
 val tablet = p0.child("tablet").value.toString()

 if (!oldValue && check){    //oldValueはリスナー外で定義している
       val tableNum = p0.key.toString()
       readData(tableNum, tablet)  //テーブルの情報を全部読み取り、レシート印刷
  }

 oldValue = check

時々レシートが２枚印刷される問題は、この実装で解決しました。

直感的なUI

前に導入しようとしていた伝票システムは、全体的に単色で、メニューの選択画面が文字のリストで、とても見にくかったとのことでした。

なので自分は極力文字を少なく・画像やベクター図を多く、見やすい色やフォントサイズを心がけました。
また、１つの画面で全ての操作を終えるのはなく、各画面で行う操作は１つにしました。

スタッフは画面毎の単純な質問に答えるように操作していきます。

（例えば、日本酒を選択するとおちょこの数を質問し、ワインだとグラスの数、焼酎だと飲み方、ソフトドリンクだと、氷の有無やアイスorホットを質問します。）

👇下は、焼酎のボトルを注文するときの画面遷移

流れるように素早い操作が可能なように心がけましたが、そうすると一方でミスが増える可能性がでてきます。
なので、できるだけミスを無くすために、また、お客様の急な変更に対応できるように（「やっぱビール３つで！」みたいな）、
注文が３種類以上の時は自動的に【注文内容は大丈夫？】画面に遷移するようにしました！
ここの画面から、商品の追加や数量変更・削除も可能です。

Qiita投稿用 pic.twitter.com/Dx0tktsMii
— 山本燿司 (@baske0806) 2019年5月29日

コツコツ改善 ①SoftKeyboardのフォーカス調節

あとは、小さなことなんですが、注文の最後の画面では、EditTextのフォーカスをデフォルトで外しているのですが、メモを残すボタンタップ時にソフトキーボードがでてくるようにしました！

このコード👇で、ソフトキーボードを出す実装ができます。

fun showSoftKeyboard(view:View) {
  if (view.requestFocus())
  {
    val imm = getSystemService(Context.INPUT_METHOD_SERVICE) as InputMethodManager
    imm.showSoftInput(view, InputMethodManager.SHOW_IMPLICIT)
  }
}

：参考ページ　【How to Hide and Show Soft Keyboard in Android】

コツコツ改善 ②ホーム画面整理

これは、システム関係ないのですが、もし誤操作でホーム画面に戻ってしまっても、一目でどれが伝票システムアプリかわかるようにしました。（完全人力）

終わりに

ハード機器の選定から、DB設計、UIまで、全部自分１人でやると色々わかってきますが、１番思うことは、自分のレベルの低さです。（本当に）

そして、フィードバックの大切さ。個人開発のアプリでは今回のような直接的なフィードバックがない分、色々なLogや、ユーザーのデータが相当すると思うので、次に活かしたいです。

あとはメンターの大切さ。今回自分は登録だけして使いませんでしたが、英語版ではCodeMentor、日本語版ではMENTAなどがあるので、積極的に利用していきたいです。

最後まで読んで頂いてとても嬉しいです！
ありがとうございました！