Qute Templating Engineのサポート - Quarkus Tools for Visual Studio Codeで提供開始

Quarkus Tools for Visual Studio Code 1.10.0に含まれるQuteの注目すべき機能は以下のとおりです。

Quarkus: Generate a Quarkus project コマンドを使用すると、ダウンロードしたQuarkusプロジェクトをQuteテンプレートで初期化するために、 RESTEasy Qute エクステンションを追加するオプションがあります。

Quteのテンプレートを自分で始めてみたいですか？ 方法については こちらを参照して下さい。

Quteのテンプレートを生成したり、アクセスするための迅速で簡単な方法は、CodeLensのサポートを利用することです。 qute.codeLens.enabled 設定は、Qute CodeLens を表示するかどうかを制御します。

これで、どの Template 属性にも、対応する Qute テンプレートを生成するか、既存のテンプレート・ファイルに移動するかのオプションが表示されるようになりました。

さらに、 @CheckedTemplate のアノテーションが付いた Java ファイルは、その TemplateInstance フィールドに、対応する Qute テンプレートを生成するか、既存のテンプレート・ファイルに移動するかのオプションが表示されます。

テンプレートファイルは常にプロジェクトの既存の src/main/resources/templates ディレクトリの下に作成されます。なければ、テンプレートを格納するために必要なディレクトリを作成します。

対応するJavaリソースと組み合わされた全てのQuteファイルは、定義への移動、ホバー、オートコンプリートなど、多くの言語クライアント機能をサポートしています。これらのそれぞれについて、記事の中でさらに掘り下げていきます。

これらの機能は、Quteのテンプレートを効率的に使い始め、複数のテンプレートファイルを操作するのに便利です

Qute言語サーバーは、ビルトインおよびユーザー定義のJavaクラスをサポートしており、そのメソッドに対するパラメータ補完や検証を行うことができます。これを利用して、Javaに関連するミスを簡単に回避してください。

Java補完と検証のサポートに加え、組み込みおよびユーザー定義のJavaクラスに対するタイプホバーリングもサポートしています。

多くの言語クライアントと同様に、Quteテンプレートでも連動編集がサポートされ、複数のパラメータ式の名前を同時に変更することができるようになりました。この機能を有効にするには、 settings.json で、 editor.linkedEditing を true に設定する必要があります。

Quteのテンプレートは、テンプレート言語のセクションを使用して、コンパイルと表示時に必要なロジックを実行します。これをサポートするために、拡張のQuteサポートは、利用可能なすべてのQuteセクションと、それらが取るパラメータ、およびその使用方法の小さなコードスニペットを補完リストに入力します。

Quteの各セクションについては、 こちらをご覧ください。

Quarkus Tools for Visual Studio Codeを使用したQuteテンプレートには、JavaおよびQuteの検証が含まれており、診断やクイックフィックスの提案が行われます。

qute.validation.enabled は、現在のワークスペースのグローバルな検証を制御し、 qute.validation.excluded は、検証を無視すべき Qute テンプレートを入力することができます。

利用可能な検証のいずれかが、開発の妨げになっている場合、Qute テンプレートを開 く際にエディタバーの右上に表示されるボタンを使って、現在のファイルの Qute 検証 をワンクリックで無効にするか、Qute 関連の診断に毎回表示される「クイックフィックス」 を使ってワークスペース全体の検証を無効にしてください。

対応するJavaメソッドと対になって、組み込みのJavaクラスは、Quteテンプレートエンジンによって利用可能になった組み込みのQute値リゾルバを持ち、評価されて値を出力、または値に解決します。Quarkus Tools for Visual Studio Codeは、これらの組み込み値リゾルバの補完、ホバー、スニペット生成をサポートしています。

これらのQute値リゾルバの一覧は こちらをご覧ください。

テンプレート拡張メソッドは、データオブジェクトのアクセス可能なプロパティのセットを拡張するために使用されます。Quarkus Tools for Visual Studio Code の Qute サポートでは、マーク付きの @TemplateExtension Java メソッドをサ ポートしており、与えられたデータモデルを拡張することができます。

詳しくは こちら（ @TemplateExtension ）をご覧ください。

@Named でアノテーションされた CDI Bean は、cdi および/または inject 名前空間を通して、任意のテンプレートで参照することができます。Quarkus Tools for Visual Studio Codeは、Beanの補完と定義ナビゲーションのサポートを提供します。

Beansインジェクションについて詳しくは こちらをご覧ください。

この記事では、Quarkus Tools for Visual Studio CodeのQuteテンプレートサポートが提供する注目すべき機能のいくつかを紹介出来ていると嬉しく思います。次回Quarkusプロジェクトで作業を行う際に、これらを試してみることをお勧めします。

ご意見・ご感想はこちらお気軽に GitHub issueをオープンしてください。

Quteテンプレートエンジンに多くの実験的な機能が追加されているため、Qute言語サポートの更新を継続し、世界中のQuarkus開発者や意欲的な開発者にQuteを試してもらうことを目指しています。

参考までに重要なリンクをいくつか挙げておきます。