1.Yunas Tutorial(基本設定)
2.Yunas Tutorial(DB)
3.Yunas Tutorial(バッチ)

Tutorial(基本設定)

See Sample Project

プロジェクトへの追加

最新のyunasライブラリはMaven Centralから取得可能です。

build.gradle

group: 'io.github.cobayo', name:'yunas-framework',version: '1.0.3'

application.properties

src/main/resources/application.properties

実行環境 (local,dev,production) は YUNAS_PROFILES_ACTIVE 環境変数で設定できます。

export YUNAS_PROFILES_ACTIVE=local

Yunasは自動的に application-<実行環境名>.properties を設定ファイルをとして選択します。もし設定されていない場合、あるいは YUNAS_PROFILES_ACTIVEに production が設定されている場合は自動的に

application.properties

を選択します。

デフォルト port　の変更

デフォルトポートは 10421 になります。
以下のように application.properties で変更可能です。

yunas.port=8080

起動方法

ローカル環境などでは以下のようにgradleコマンドで起動できます。

gradle run

本番配布用zipを gradle distZipで作成可能です。

gradle distZip  

unzip build/distribution/xxxxx.zip  

./xxxxx/bin/xxxxx  

実行可能Jarに固める場合はfatJarの利用を勧めています。

build.gradle

apply plugin: 'eu.appsatori.fatjar'

buildscript > dependencies に追加

classpath 'eu.appsatori:gradle-fatjar-plugin:0.3'

fatJar Config を build.gradleに追加

fatJar {
    baseName = archivesBaseName
}

jarの作成

gradle fatJar

Launch by Java Command

java -jar xxxx.jar

Set Http Routing

以下のメソッドで RestAPI用のルーティングを設定できます。

Yunas.Rest.get
Yunas.Rest.post
Yunas.Rest.put
Yunas.Rest.delete

ContentType は自動的に application/json となり、
戻り値のオブジェクトも自動的JSON Stringへ変換されます。
(Stringを返した場合はそのまま request bodyとして返却されます。自前でJSON化したい時のためです。)

例1(Kotlin)

package sample


import yunas.Context
import yunas.Controller
import yunas.ModelAndView
import yunas.Yunas


fun main(args: Array<String>) {
    
        // Top Page (Return html with Thymeleaf)
        Yunas.Rest.get("/", object : Controller {
            override fun action(context: Context): Any {
                return mapOf("message" to "Hello World")
            }

        })
}

(gradle上でmainClassName=samaple.MainKtと)

例1(Java)

import yunas.Context
import yunas.Yunas  
import yunas.Controller

public class Main {

    public static void main(String[] args) {


        Yunas.Rest.INSTANCE.get("/top",new TopController());

    }
    
    private static class TopController implements Controller {
    
             @Override
             public Object action(Context context) {
                    Map<String,String> map = new HashMap<>();
                    map.put("message","Hello World");
                    return map;
             }
    
    }
}

GET 127.0.0.1:10421/top アクセスすると


{"message":"Hello World"}

自動的にJSON化されレスポンスされています。

String型を返した場合はそのままの内容がレスポンスされます。

Webページ表示はThymeleafを使います。

以下のメソッドでルーティングを設定します。

Yunas.get
Yunas.post

ContentType は自動的に text/html となります。メソッドの戻り値はModelAndView Map String のいずれかのである必要があります。 Thymeleafを使わずhtml文字列を表示したい場合はStringで返してください。
ModelAndViewあるいはMapの場合は自動的にThymeleafのModelAndViewにセットされます。

例2(Kotlin)

package sample


import yunas.Context
import yunas.Controller
import yunas.ModelAndView
import yunas.Yunas


fun main(args: Array<String>) {
    
        // Top Page (Return html with Thymeleaf)
        Yunas.get("/", object : Controller {
            override fun action(context: Context): Any {
                return ModelAndView(mapOf("message" to "Hello World"),"index")
            }

        })
}

mapOf("message" to "HelloWorld") “message” をThymeleaf上で変数として使えます。

index は Thymeleaf Template　です以下から選ばれます。

 src/main/resources/templates/index.html

静的ファイルについて

静的ファイルは(css,js,img…etc) 以下のパスに配置してください。

 src/main/resources/static/

以下のように呼び出せます。

src/main/resources/static/test.css

-> http[s]://yourdomain/text.css