はじめに

openapi generator を Spring Boot で利用してみる で openapi-generator を用いて Spring MVC のコントローラ(のインタフェース)を自動生成してみました。

その後、これを実際に利用してみて気づいたのですが、ハンドラ(controllerのメソッド)に独自の引数を生やしたいことが多く、このままだと非常に不便です。

特に結論はなく、情報収集です。

Google の検索 URI「http://www.google.com/search?q=jellyfish」について考えてみよう。Google Web アプリケーションがパス変数を使用していたならば、この URI はアルゴリズムの実行結果というよりも、ディレクトリのようになっていただろう（http://www.google.com/search/jellyfish）。

…

今回の成果物

• https://github.com/yukihane/hello-java/tree/master/spring/openapi-sample

設定

build.gradle

• openapi-generator-gradle-plugin

• spring generator

辺りを参考にしています。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

plugins {
    id 'eclipse'
    id 'org.openapi.generator' version '4.3.1'
}

ext {
    openApiOutputDir = "$rootDir/build/generated/openapi"
}

sourceSets.main.java.srcDirs += ["$openApiOutputDir/src/main/java"]

dependencies {
    // これらは自動生成クラスが import しているので必要
    implementation 'org.springframework.boot:spring-boot-starter-validation'
    implementation 'org.openapitools:jackson-databind-nullable:0.2.1'
    compileOnly 'io.swagger:swagger-annotations:1.6.2'
}

openApiGenerate {
    generatorName = 'spring'
    inputSpec = "$rootDir/specs/test.yml"
    outputDir = "$openApiOutputDir"
    apiPackage = 'org.openapi.example.api'
    modelPackage = 'org.openapi.example.model'
    configOptions = [
        dateLibrary: 'java8',
        interfaceOnly: 'true',
        skipDefaultInterface: 'true',
    ]
}

compileJava.dependsOn tasks.openApiGenerate

specs/test.yml

上の build.gradle で指定している、今回の OpenAPI spec ファイルです。

(2021-10-16 更新)

Spring Boot プロジェクトにLombokとMapStructを追加し、かつ Eclipse で開発を行う場合の設定です。

同じようなことを何回か書いてきた気がするのですが、結局どうすれば良いの？というのをまとめて書いたものが無いっぽいので改めて記事に起こしました。

Gradle で integration-test 用にテストディレクトリを分けようとして リファレンス を参考に build.gradle を編集しました。

しかし、コンパイル対象には入っているようですがこのテストが実行されている気配がありません。

推測されないような文字列を動的に生成しURLに利用できるような仕組みを調べていますが、その調査メモです。

ちょうど私が調べている時期と重なって、関心対象が同じ資料がアップロードされていました:

KeycloakをIdPにしてSpring Security OAuth 2.0 Login/Client を試してみる で作成したプログラムの自動テスト方法です。

今回のコードも前回と同じく次のディレクトリにあります:

• https://github.com/yukihane/hello-java/tree/master/spring/oidc-example

まず結論なのですが、リファレンスに説明がありますのでここを参照しましょう、ということになります:

これまで、LombokとMapStructを併用しようとした場合、そのままだと不具合(MapStructのアノテーションプロセッシングが動作しない)があり、ちょっとひと手間かけてその不具合を回避する必要がありました。

元ネタ:

• 古い Eclipse の起動時に UnsatisfiedLinkError が発生する - スタック・オーバーフロー

いにしえのJava世界では、Win32APIにアクセスするためにSWTを利用していたそうです(リンク先のエントリは2005年のもの。私がJava始めるまえの話だ…)。

はじめに

Spring Initializrを使ってGradle形式でプロジェクトを作成した場合、どうやってSTS(Eclipse)へインポートするのか逡巡しました。

はじめに

Spring Boot で Spring Security OAuth 2.0 Login / Client を利用する手順をまとめます。

また、認可サーバ(IdP)にはローカルで立てたKeycloakを用いますのでそちらのセットアップ手順も記載します。

現在、新しいプロジェクトに参画してGitのブランチ戦略を考えています。

何回かブランチ戦略を考え、そして運用してきたのですが、思うところを書いてみます。

• OAuth2ClientAutoConfiguration

上記のクラスが Import しているもの(など):

• OAuth2ClientRegistrationRepositoryConfiguration

  • ClientRegistrationRepository bean 定義。

    • OAuth2ClientProperties(spring.security.oauth2.client)プロパティから定義を取得して生成するインメモリレジストリを生成。

• OAuth2WebSecurityConfiguration

  • OAuth2AuthorizedClientService bean 定義。

  • OAuth2AuthorizedClientRepository bean 定義。

  • WebSecurityConfigurerAdapter デフォルト実装。

    • 全てのリクエストに authenticated を要求する。 oauth2Login, oauth2Client 有効化。

リファレンスリンク: