CodeReady Studio ツールのスタートガイド

Red Hat CodeReady Studio 12.19

Red Hat CodeReady Studio ツールの使用方法

Eva-Lotte Gebhardt

Levi Valeeva

Supriya Takkhi

Red Hat Developer Group Documentation Team

概要

本書のトピックでは、開発を効率的に進めるために Red Hat CodeReady Studio ツールの使用する方法を説明します。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、今後の複数のリリースで段階的に用語の置き換えを実施して参ります。詳細は、弊社 の CTO、Chris Wright のメッセージ を参照してください。

第1章 CodeReady Studio の Git の基本

CodeReady Studio には、開発者がグラフィカルインターフェースから Git リポジトリーを管理できる Git Perspective が含まれています。ここでは、Git Perspective における Git プロジェクトの基本ワークフローの概要と、最も一般的な Git 関連のタスクを実行する方法を説明します。

1.1. Git Perspective の設定

CodeReady Studio で Git Perspective を開く方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowPerspectiveOpen PerspectiveOther とクリックします。

    crs perspectives

    Open Perspective ウィンドウが表示されます。

    crs locating git perspective
  3. Git を選択します。
  4. Open をクリックします。

    Git Repositories ビューが表示されます。

    crs git repo view

1.2. Git Perspective でのリポジトリーの管理

1.2.1. 新規 Git リポジトリーの作成

Git Perspective を使用して新規 Git リポジトリーを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Create a new Git Repository and add it to this view アイコンをクリックします。

    crs git perspective create a new git repo

    Create a Git Repository ウィンドウが表示されます。

    crs creat a new git repo

    デフォルトの Repository ディレクトリー へのパスが自動的に生成されます。リポジトリーの保存先へのパスを選択し、リポジトリーの作成を続行します。

    必要に応じて、Create as bare repository チェックボックスを選択します。

    注記

    ベアリポジトリーは中央リポジトリーに推奨されますが、開発環境には推奨されません。ベアリポジトリーには、ソースファイルの作業用のコピーや、チェックアウトされたコピーが含まれません。そのため、ファイルの編集や変更のコミットができません。さらに、リポジトリーの Git リビジョンの履歴は、.git サブフォルダーではなく、root フォルダーに保存されます。

  4. Create をクリックします。

    新しい Git リポジトリーがローカルマシンに作成され、Git Repositories ビューに表示されます。

    crs new git repo

1.2.2. 既存のローカル Git リポジトリーの追加

Git Perspective を使用して、ローカル Git リポジトリーを CodeReady Studio に追加する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Add an existing local Git Repository to this view アイコンをクリックします。

    crs git perspective add a local git repo

    Add Git Repositories ウィンドウが表示されます。

  4. Browse をクリックして、ローカルの Git リポジトリーを見つけます。

    crs adding a local git repo
  5. Search results フィールドで、.git ファイルへのパスを表示するチェックボックスを選択します。
  6. Add をクリックします。

ローカルリポジトリーが Git Repositories ビューに表示されます。

crs local git repo

1.2.3. 既存の Git リポジトリーのクローン作成

Git Perspective を使用して、オンラインにすでに存在するリポジトリー (GitHub、GitLab) のローカルクローンを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Clone a Git Repository and add the clone to this view アイコンをクリックします。

    crs git perspective clone a git repo

    Clone Git Repository ウィンドウが表示されます。

    crs cloning a git repo
  4. ソースリポジトリーのアドレスを URI フィールドに追加します。

    Host および Repository path フィールドが自動的に入力されます。

  5. Next をクリックします。
  6. クローンを作成するブランチを選択します。
  7. Next をクリックします。
  8. Directory パスとInitial branch が正しく設定されていることを確認してください。

    crs verifying pah to repo
  9. Finish をクリックします。

クローンしたリポジトリーが、CodeReady Studio の Git Repository ビューに表示されます。

crs cloned git repo

1.2.4. リポジトリーのリモートの追加

Git Perspective にリポジトリーを設定したら、リポジトリーにリモートを追加します。これは、新たに作成または追加されたリポジトリーに 1 度だけ必要な設定ステップです。

Git Perspective を使用してリポジトリーにリモートを設定する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. リポジトリーを展開します。

    crs creating a remote
  4. RemotesCreate Remote と右クリックします。

    New Remote ウインドウが表示されます。

    crs naming the remote
  5. リモートに名前を付けます。
  6. Configure push が選択されていることを確認します。
  7. Create をクリックします。

    Configure Push ウィンドウが表示されます。

    crs configure push window
  8. Change をクリックします。

    Select a URI ウィンドウが表示されます。

    crs select uri window
  9. ソースリポジトリーの URI、ユーザー名、およびパスワードを追加します。

    Host および Repository パスフィールドが自動的に入力されます。

  10. Finish をクリックします。
  11. Save をクリックします。

新たに追加されたリモートが、CodeReady Studio の Git Repositories ビューに表示されます。

crs remote created

1.3. Git Perspective でのブランチの管理

1.3.1. 新規ブランチの作成

Git パースペクティブを使用して新規ブランチを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. リポジトリーを展開します。
  4. branchesRemote Tracking で、masterCreate Branch を右クリックします。

    crs create new branch

    Create Branch ウインドウが表示されます。

    crs create new branch window
  5. Select をクリックして、新規ブランチのソースを選択します。
  6. ブランチに名前を付けます。
  7. Configure upstream for push and pull および Checkout new branch チェックボックスを選択します。
  8. When pulling フィールドでオプションを選択します。
  9. Finish をクリックします。

新たに追加されたブランチが、CodeReady Studio の branchesLocalGit Repositories ビューに表示されます。

crs new branch

1.3.2. ブランチの使用

Git Perspective で埋め込みのターミナルを開き、作成したブランチを使用する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Shift+Ctrl+Alt+T キーを押します。

    Launch Terminal ウインドウが表示されます。

    crs launch terminal window
  4. Local Terminal を選択します。
  5. EncodingDefault (ISO-8859-1) に設定します。
  6. OK をクリックします。

    Terminal ウインドウにコマンドラインターミナルが表示されます。

    crs terminal

デフォルトでは、現在の作業用ディレクトリーは、現在のユーザーのホームディレクトリーであることに注意してください。

1.3.3. ローカルリポジトリーの更新

特に共有リポジトリーで作業を行う場合に、マージの競合を防ぐには、変更をマージする前にローカルリポジトリーを更新します。
ローカルリポジトリーを更新するには、リモートリポジトリーから変更をプルし、ローカルリポジトリーにマージします。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. repositoryPull と右クリックします。

    crs pull

    Pull Results ウインドウが表示されます。

    crs pull request
  4. Close をクリックします。

これで、リモートリポジトリーからの変更がローカルリポジトリーにマージされます。

1.4. 変更のコミットおよびプッシュ

CodeReady Studio で変更をコミットおよびプッシュする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. repositoryCommit と右クリックします。

    crs commit

    Git Staging ビューが表示されます。

    crs git perspective stage files to commit
  4. ステージする変更を選択します。
  5. Add selected files to the index アイコンをクリックし、変更をステージします。
  6. Commit Message フィールドにコミットメッセージを追加します。

    Author および Committer フィールドが自動的に入力されます。

  7. Commit をクリックして変更をコミットするか、Commit and Push をクリックして変更をコミットし、リモートリポジトリーにプッシュします。

Commit and Push オプションを選択すると、リポジトリーアドレスと、リポジトリーのアクセスユーザー名およびパスワードの入力を要求されることに注意してください。

第2章 CodeReady Studio における Maven の基本

Maven はアプリケーション開発の標準化されたビルドシステムを提供し、1 つ以上のリポジトリーから依存関係のフェッチを容易にします。

ルート Maven プロジェクトは、複数の Maven モジュール (サブプロジェクト) のアグリゲーターとして提供できます。Maven プロジェクトの一部である各モジュールには、<module> エントリーがプロジェクトの pom.xml ファイルに追加されます。pom.xml には <module> エントリーが含まれ、アグリゲーター pom とも呼ばれます。

モジュールがプロジェクトに含まれる場合は、親プロジェクトディレクトリーから実行された 1 つコマンドにて、すべてのモジュールで Maven ゴールを実行できます。

2.1. 新規 Maven プロジェクトの作成

CodeReady Studio で新しい Maven プロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowShow ViewOther とクリックします。

    Show View ウインドウが表示されます。

    crs pe explorer view
  3. 検索フィールドに Project Explorer と入力します。
  4. Project Explorer を選択します。
  5. Open をクリックします。

    Project Explorer ビューが表示されます。

    crs maven project in project explorer
  6. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs wizard maven project
  7. Wizards フィールドに Maven と入力します。
  8. Maven Project を選択します。
  9. Next をクリックします。

    New Maven Project ウインドウが表示されます。

    crs creation of maven project
  10. Create a simple project チェックボックスを選択します。

    注記

    Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。

    代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを jar または war に設定します。

  11. Browse をクリックしてワークスペースの場所を選択します。
  12. Next をクリックします。

    crs maven project creation2
  13. グループ ID とアーティファクト ID を入力します。

    注記

    ID の値には、スペースや特殊文字を使用できません。使用できる特別文字は、ピリオド (.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例は org.company-name_project-name です。

    必要に応じて、プロジェクトに名前を付け、説明を追加できます。

  14. Packagingpomjar、または war に設定します。
  15. Finish をクリックします。

新たに作成された Maven プロジェクトが Project Explorer ビューに表示されます。

2.2. 既存の Maven プロジェクトのインポート

既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

2.2.1. ローカルに保存された既存の Maven プロジェクトのインポート

ローカルに保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. FileImport とクリックします。

    crs file import

    Import ウインドウが表示されます。

    crs importing maven project
  3. Select an import wizard フィールドに Maven と入力します。
  4. Existing Maven Projects を選択します。
  5. Next をクリックします。

    Import Maven Project ウインドウが表示されます。

    crs importing local maven project
  6. Browse をクリックして、Maven プロジェクトを見つけます。
  7. Add project(s)to working set チェックボックスを選択します。
  8. Finish をクリックします。

ローカルの Maven プロジェクトが Project Explorer ビューに表示されます。

2.2.2. リモートで保存された 既存の Maven プロジェクトのインポート

リモートで保存された既存の Maven プロジェクトを CodeReady Studio にインポートする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。
  3. Clone a Git repository and import existing Maven projects アイコンをクリックします。

    crs clone a git repository and import existing maven projects

    Check out as Maven project from SCM ウィンドウが表示されます。

    crs importing remote maven project
  4. ソースリポジトリーのアドレスを SCM URL フィールドに追加します。
  5. Next をクリックします。

    Select Project Location ウインドウが表示されます。

    crs remote maven project location
  6. Browse をクリックしてワークスペースの場所を選択します。
  7. Finish をクリックします。

リモート Maven プロジェクトが Git Repositories ビューに表示されます。

2.3. 新しい Maven モジュールの作成

新しい Maven モジュールの作成方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs wizard maven module
  3. Wizards フィールドに Maven と入力します。
  4. Maven Module を選択します。
  5. Next をクリックします。

    New Maven Module ウインドウが表示されます。

    crs creating a new maven module
  6. Create a simple project チェックボックスを選択します。

    注記

    Create a simple project チェックボックスを選択すると、archetype の選択が省略されます。また、プロジェクトタイプは、マルチモジュールの Maven プロジェクトに必要な POM (Project Object Model) に自動的に設定されます。

    代わりにスタンドアロンの Maven プロジェクトを作成するには、Create a simple project チェックボックスを未選択にし、画面上の指示に従ってパッケージオプションを jar または war に設定します。

  7. モジュールに名前を付けます。
  8. Browse をクリックして、親プロジェクトを選択します。
  9. Next をクリックします。

    Configure Project ウインドウが表示されます。

    crs configure new maven module
  10. Packagingpomjar、または war に設定します。

    必要に応じて、モジュールに名前を付け、説明を追加できます。

  11. Finish をクリックします。

新たに作成された Maven モジュールが Maven プロジェクトの下に表示されます。

2.4. Maven 依存関係の Maven プロジェクトへの追加

CodeReady Studio で Maven プロジェクトに Maven 依存関係を追加する方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer を開きます。
  3. Maven の projectMavenAdd Dependency を右クリックします。

    crs maven add dependency

    Add Dependency ウインドウが表示されます。

    crs maven dependency enter groupid
  4. Enter groupId, artifactId or sha1 prefix or pattern フィールドに、グループ ID またはアーティファクト ID を入力します。

    上記のフィールドは自動的に入力されます。

  5. OK をクリックします。

依存関係がプロジェクトの pom.xml ファイルに追加されます。

2.5. Maven サポートを Maven 以外の既存プロジェクトへ追加

Maven サポートを使用せずに作成されたアプリケーションに Maven サポートを追加する方法を説明します。

  1. CodeReady Studio を起動します。
  2. Project Explorer を開きます。
  3. projectConfigureConvert to Maven Project を右クリックします。

    crs convert to maven project

    Create a new POM ウインドウが表示されます。

    crs java to maven conversion

    すべてのフィールドは自動的に入力されます。グループ ID またはアーティファクト ID を変更する場合は、値にスペースまたは特殊文字を使用できません。使用できる特別文字は、ピリオド (.)、アンダースコア (_)、およびダッシュ (-) のみです。一般的なグループ ID またはアーティファクト ID の例は org.company-name_project-name です。

  4. Finish をクリックします。

    新たに生成された pom.xml ファイルが Java プロジェクトに表示されます。

2.6. その他のリソース

  • Maven ソフトウェアプロジェクトの管理および解釈ツールを使用する方法についての詳細は、JBoss Community Archive を参照してください。

第3章 CodeReady Studio でのアプリケーションデプロイメント

CodeReady Studio 内からサーバーにアプリケーションをデプロイするには、サーバーに関する情報で IDE を設定する必要があります。ローカルサーバーの場合、この情報には以下が含まれます。

  • サーバーランタイム環境 (サーバーの場所、ランタイム JRE、設定ファイルの詳細など)
  • サーバーアダプターとサーバーランタイム環境の管理設定 (アクセスパラメーター、起動引数、パブリッシュオプションなど)

JBoss Server Tools を使用すると、Runtime Detection (ランタイム検出) を使用して、ローカルサーバーを効率的に設定し、 CodeReady Studio と使用できるようにすることができます。この機能は、アプリケーションのデプロイとテストを行うサーバーを迅速に設定するのに役立ちます。

3.1. ローカルサーバーの設定

Runtime Detection (ランタイム検出) は、指定のローカルシステムパスを検索し、特定タイプのランタイムサーバーを見つけます。Runtime Detection は、見つかったサーバーに対してデフォルトのサーバーランタイム環境とデフォルトのサーバーアダプターの両方を自動的に生成します。これらは、アプリケーションを即座にデプロイするためにそのまま使用したり、要件に合わせてカスタマイズしたりできます。

CodeReady Studio でローカルサーバーを設定する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowPreferences をクリックします。

    crs preferences

    Preferences ウィンドウが表示されます。

    crs jboss runtime detection
  3. 検索フィールドに JBoss と入力します。
  4. JBoss Runtime Detection を選択します。
  5. Add をクリックします。
  6. ランタイムサーバーが含まれるディレクトリーを見つけます。
  7. Open をクリックします。

    Searching for runtimes ウィンドウが表示されます。

    crs searching for runtimes
  8. OK をクリックします。
  9. ランタイムサーバーのディレクトリーへのパスを選択します。

    crs select path to runtime server
  10. Apply and Close をクリックします。

3.2. リモートサーバーの設定

CodeReady Studio でリモートサーバーを設定する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs select wizard server
  3. 検索フィールドに Server と入力します。
  4. Server を選択します。
  5. Next をクリックします。

    Define a New Server ウィンドウが表示されます。

    crs select the server type
  6. サーバータイプを選択します。
  7. Next をクリックします。

    Create a new Server Adapter ウィンドウが表示されます。

    crs create a new server adapter
  8. Remote チェックボックスを選択します。
  9. Controlled by オプションを選択します。
  10. Server lifecycle external managed チェックボックスを選択します。
  11. Assign a runtime to server チェックボックスを選択します。
  12. Next をクリックします。

    JBoss Runtime ウィンドウが表示されます。

    crs runtime server window
  13. Home Directory フィールドの Browse をクリックして、ランタイムサーバーを見つけます。
  14. Next をクリックします。

    Remote System Integration ウィンドウが表示されます。

    crs remote system integration window
  15. Remote Server Home フィールドで Browse をクリックします。

    Browse remote system ウインドウが表示されます。

    crs browse remote server
  16. リモートサーバーが含まれるディレクトリーへのパスを指定します。
  17. Finish をクリックします。

3.3. アプリケーションのデプロイ

ローカルサーバーの設定後に、サーバーアダプターを使用して CodeReady Studio からサーバーにアプリケーションをデプロイできます。サーバーアダプターは、アプリケーションとサーバー管理を簡単にデプロイできるように、サーバーと CodeReady Studio 間のランタイムの通信を可能にします。

CodeReady Studio のサーバーにアプリケーションをデプロイする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. projectRun asRun on Server を右クリックします。

    crs run on server

    Run on Server ウインドウが表示されます。

    crs run on server window
  3. Choose an existing server チェックボックスを選択します。
  4. デプロイするサーバーを選択します。
  5. Finish をクリックします。

内部の CodeReady Studio Web ブラウザーでアプリケーションが開かれます。

第4章 CodeReady Studio の JBoss EAP および JBoss WFK の基本

Eclipse IDE は、Red Hat JBoss Enterprise Application Platform (JBoss EAP) および Red Hat JBoss Web Framework Kit (JBoss WFK) でのアプリケーション開発およびデプロイメントをサポートします。

ただし、最初に Maven リポジトリーを設定する必要があります。この設定は、Red Hat Central で提供される、エンタープライズバージョンの Maven プロジェクトサンプルの使用に不可欠です。これらのプロジェクトは JBoss EAP へのデプロイメントを目的としており、JBoss EAP リポジトリーおよび JBoss WFK リポジトリーへの IDE のアクセスが必要になります。

4.1. Maven リポジトリーの設定

Maven リポジトリーを設定する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowPreferences をクリックします。

    crs preferences

    Preferences ウィンドウが表示されます。

    crs jboss maven integration
  3. 検索フィールドに JBoss と入力します。
  4. JBoss Maven Integration を選択します。
  5. Configure Maven Repositories をクリックします。

    Configure Maven Repositories ウインドウが表示されます。

    crs configure maven repos
  6. Add Repository をクリックします。

    Add Maven Repository ウインドウが表示されます。

    crs add maven repo
  7. Profile ID フィールドの下向き矢印をクリックします。
  8. redhat-ga-repository を選択します。

    他のフィールドは自動的に入力されます。

  9. OK をクリックします。
  10. Finish をクリックします。

    Confirm File Update ウインドウが表示されます。

  11. Yes をクリックします。
  12. Apply and Close をクリックします。

その他のリソース

4.2. JBoss EAP の設定

Eclipse で JBoss EAP を設定するには、IDE がローカルまたはリモートのランタイムサーバーを示すようにする必要があります。これにより、IDE と JBoss EAP サーバー間の通信チャネルが確立され、デプロイメントおよびサーバー管理のワークフローが効率的になります。

CodeReady Studio で JBoss EAP をインストールする方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. WindowPreferences をクリックします。

    crs preferences

    Preferences ウィンドウが表示されます。

    crs jboss runtime detection
  3. 検索フィールドに JBoss と入力します。
  4. JBoss Runtime Detection を選択します。
  5. Download をクリックします。

    Download Runtimes ウィンドウが表示されます。

    crs download runtimes
  6. 必要な JBoss EAP バージョンを選択します。

    注記

    JBoss EAP バージョン 6.0.x 以前を選択した場合は、画面の指示に従います。6.0.x よりも新しいバージョンを選択した場合は、以下の手順に従います。

  7. Next をクリックします。

    Credentials ウインドウが表示されます。

    crs enter redhat credentials
  8. Add をクリックします。
  9. access.redhat.com のユーザー名とパスワードを入力します。
  10. OK をクリックします。
  11. Next をクリックします。

    ライセンス契約の内容を確認します。ライセンス契約に同意し、Next をクリックしてインストールを続行します。

    Download Runtimes ウィンドウが表示されます。

    crs downloading runtimes
  12. Browse をクリックして、Install folder を選択します。
  13. Browse をクリックして、Download folder を選択します。
  14. Finish をクリックします。

    Runtime のダウンロードとインストールには時間がかかる場合があるため注意してください。

    JBoss Runtime Detection ウインドウが表示されます。

    crs jbos runtimes detection last step
  15. JBoss EAP インストールファイルへのパスを選択します。
  16. Apply and Close をクリックします。

検証手順

  1. WindowShow ViewOther とクリックします。

    crs window show view other

    Show View ウインドウが表示されます。

    crs show view servers
  2. 検索フィールドに Servers と入力します。
  3. Servers を選択します。
  4. Open をクリックします。

    Servers ビューが表示されます。

新たに追加された JBoss EAP が Servers ビューに表示されます。

crs servers view

第5章 CodeReady Studio での OpenShift の基本

CodeReady Studio には OpenShift Application Explorer ビューが含まれています。これにより、ユーザーエクスペリエンスが簡素化され、内部ループで簡単および迅速にフィードバックすることができ、デバックも容易および迅速に行うことができます。

OpenShift Application Explorer は、CodeReady Studio でデフォルトのビューとして設定されています。手動で開く必要がある場合は、「OpenShift Application Explorer ビューの設定」を参照してください。

5.1. OpenShift Application Explorer ビューの設定

CodeReady Studio で OpenShift Application Explorer を開く方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowShow ViewOther とクリックします。

    crs window show view other

    Show View ウインドウが表示されます。

    crs select openshift app explorer
  3. 検索フィールドに OpenShift と入力します。
  4. OpenShift Application Explorer を選択します。
  5. Open をクリックします。

    OpenShift Application Explorer ビューが表示されます。

crs openshift app explorer view

5.2. OpenShift Application Explorer を使用した OpenShift クラスターへの接続

OpenShift Application Explorer を使用して CodeReady Studio で OpenShift クラスターにログインする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を開きます。
  3. Can't connect to cluster. Click to loging. をクリックします。

    login to openshift cluster

    Login ウインドウが表示されます。

    crs os browser sign in
  4. URL フィールドに OpenShift API URL を貼り付けます。

    OpenShift API URL 経由でクラスターにアクセスする方法の詳細は、「Red Hat OpenShift - Accessing your Services」を参照してください。

  5. ユーザー名とパスワードまたはトークンを入力します。
  6. Finish をクリックします。

5.2.1. ブラウザーベースのトークンの取得

ユーザー名とパスワード、またはトークンを提供する代わりに、ブラウザーベースのトークンを取得して、OpenShift クラスターにログインすることができます。ログインの方法には「Paste Login Command」と「Retrieve Token」の 2 つがあります。

「Paste Login Command」の使用

  1. URL フィールドに OpenShift API URL を貼り付けます。

    OpenShift API URL 経由でクラスターにアクセスする方法の詳細は、「Red Hat OpenShift - Accessing your Services」を参照してください。

  2. OpenShift Container Platform の Web UI にアクセスします。

    os3 clicking copy login command
  3. 右上隅のドロップダウンメニューをクリックします。
  4. Copy Login Command をクリックします。
  5. Display Token をクリックします。
  6. ログインコマンドをコピーします。
  7. Sign in to OpenShift ウィンドウで Paste login command をクリックします。

    crs os browser sign in
  8. Finish をクリックします。

    注記

    OpenShift 3 では、ログインコマンドは自動的にクリップボードにコピーされます。

「Retrieve Token」の使用

  1. URL フィールドに OpenShift API URL を貼り付けます。

    OpenShift API URL 経由でクラスターにアクセスする方法の詳細は、「Red Hat OpenShift - Accessing your Services」を参照してください。

  2. Retrieve token をクリックします。

    crs os browser sign in
  3. ユーザー名とパスワードを入力します。
  4. Log in をクリックします。
  5. Display Token をクリックします。
  6. Finish をクリックします。

プロジェクトが OpenShift Application Explorer ビューに表示されます。

5.3. OpenShift ツールを使用した Developer Sandbox の設定

ここでは、CodeReady Studio で Developer Sandbox にブートストラップを実行し、ログインする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を開きます。

    crs os application explorer login2
  3. OpenShift コネクションを右クリックします。
  4. Login をクリックします。

    Sign in to OpenShift ウィンドウが表示されます。

    crs bootstrap a developer sandbox cluster
  5. Red Hat Developer Sandbox をクリックします。
  6. Red Hat アカウントのクレデンシャルを入力し、Log in をクリックします。

    Developer Sandbox がブートストラップされました。

    Login to Red Hat Developer Sandbox ウィンドウが表示されます。

    crs developer sandbox is ready
  7. Next をクリックします。
  8. DevSandbox をクリックします。
  9. Red Hat アカウントのクレデンシャルを再度入力し、Log in をクリックします。
  10. Display Token をクリックします。
  11. Finish をクリックします。

    トークンが Sign in to OpenShift ウィンドウに表示されます。

    crs developer sandbox token displayed
  12. Finish をクリックします。

    これで Developer Sandbox にログインした状態となります。

Developer Sandbox が OpenShift Application Explorer ビューに表示されます。

5.4. devfile に基づくアプリケーションのビルド

devfile を基にしてアプリケーションをデプロイするには、ローカルのワークスペースに空のプロジェクトが必要です。さらに、OpenShift にも devfile コンポーネントを作成するための空のプロジェクトが必要です。コンポーネントの確立後、プロジェクトが更新され、OpenShift で作成されたローカルおよびリモートアーティファクトも更新されます。

5.4.1. 空のプロジェクトの作成

CodeReady Studio で空のプロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs create empty project in pe 1
  3. GeneralProject を選択します。
  4. Next をクリックします。

    New Project ウインドウが表示されます。

    crs create empy project in pe
  5. プロジェクトに名前を付けます。
  6. プロジェクトの場所を選択します。
  7. Finish をクリックします。

新たに作成した空のプロジェクトが Project Explorer ビューに表示されます。

5.4.2. OpenShift Application Explorer を使用した空の OpenShift プロジェクトの作成

CodeReady Studio で OpenShift Application Explorer を使用して空のプロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. OpenShift Application ExplorerNewProject の任意の場所をクリックします。

    crs os project

    New project ウインドウが表示されます。

    crs os new project window
  4. プロジェクトに名前を付けます。
  5. OK をクリックします。

新たに作成したプロジェクトが OpenShift Application Explorer ビューに表示されます。

5.4.3. OpenShift Application Explorer を使用した devfile コンポーネントの作成

CodeReady Studio で OpenShift Application Explorer を使用して devfile コンポーネントを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. ターゲットの ProjectNewComponent を右クリックします。

    crs os new component

    Create component ウィンドウが表示されます。

    crs devfile component type

  4. プロジェクトに名前を付けます。
  5. Browse をクリックして Eclipse Project を選択します。
  6. Component typejava-vertx に設定します。
  7. Project starterjava-vertx に設定します。
  8. アプリケーションに名前を付けます。
  9. Push after create チェックボックスを未選択にします。
  10. Finish をクリックします。

Console ビューが表示され、検証プロセスが表示されます。

新たに作成されたコンポーネントが、プロジェクト下の OpenShift Application Explorer ビューに表示されます。

5.4.4. OpenShift Application Explorer を使用した devfile レジストリー管理

CodeReady Studio で OpenShift Application Explorer を使用して devfile レジストリーを作成、削除、および編集する方法を説明します。

devfile レジストリーの追加

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. devfile レジストリーは、Devfile registries ノードに表示されます。

    crs devfile registries node
  4. devfile レジストリーノードを拡張すると、そのレジストリーのすべての devfile が表示されます。

    crs devfile registries node expanded

    • 新規 devfile レジストリーを追加するには、Devfile registries を右クリックし、new をクリックします。

      crs new devfile registry

      Create devfile registry ウインドウが表示されます。

      crs create devfile registry window
  5. devfile レジストリーに名前を付けます。
  6. devfile URL を貼り付けます。
  7. Finish をクリックします。

新たに作成された devfile レジストリーが Devfile registries 下の OpenShift Application Explorer ビューに表示されます。

devfile レジストリーの削除

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. devfile レジストリーは、Devfile registries ノードに表示されます。

    crs devfile registries node
  4. 展開された devfile レジストリーノードには、そのレジストリーのすべての devfile が表示されます。

    crs devfile registries node expanded

  5. devfile レジストリーを削除するには、devfile レジストリーのノードを右クリックして、delete をクリックします。

    crs delete devfile registry

devfile レジストリーが削除されます。

devfile レジストリーの編集

  • devfile レジストリーを編集するには、YAML エディターを使用します。YAML エディターは構文の検証およびコンテンツ補助を提供します。

その他のリソース

devfile の詳細は、「Introduction to Devfile」を参照してください。

5.5. S2I ファイルを基にしたアプリケーションのビルド

S2I ファイルを基にしてアプリケーションをデプロイするには、ローカルのワークスペースに空のプロジェクトが必要です。さらに、OpenShift にもコンポーネントを作成するための空のプロジェクトが必要です。コンポーネントの確立後、プロジェクトが更新され、OpenShift で作成されたローカルおよびリモートアーティファクトも更新されます。

5.5.1. ランチャープロジェクトの作成

CodeReady Studio でランチャープロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs launcher project wizard
  3. 検索フィールドに Launcher と入力します。
  4. Launcher project を選択します。
  5. Next をクリックします。

    New Launcher project ウインドウが表示されます。

    crs launcher project creation
  6. Missionrest-http に設定します。
  7. Runtimevert.x community に設定します。
  8. プロジェクトに名前を付けます。
  9. プロジェクトの場所を選択します。
  10. Finish をクリックします。

    依存関係の解決プロセスが完了するまで時間がかかることがあるため注意してください。

新た作成されたランチャープロジェクトが Project Explorer ビューに表示されます。

5.5.2. OpenShift Application Explorer での空の OpenShift プロジェクトの作成

CodeReady Studio で OpenShift Application Explorer を使用して空のプロジェクトを作成する方法を説明します。

手順

  1. OpenShift Application ExplorerNewProject の任意の場所をクリックします。

    crs os project

    New project ウインドウが表示されます。

    crs os new project window
  2. プロジェクトに名前を付けます。
  3. OK をクリックします。

新たに作成したプロジェクトが OpenShift Application Explorer ビューに表示されます。

5.5.3. OpenShift Application Explorer を使用した S2I コンポーネントの作成

CodeReady Studio で OpenShift Application Explorer を使用してコンポーネントを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. ターゲットの ProjectNewComponent を右クリックします。

    crs os new component

    Create component ウィンドウが表示されます。

    crs s2i component

  4. プロジェクトに名前を付けます。
  5. Browse をクリックして Eclipse Project を選択します。
  6. S2I の横にある矢印をクリックし、Component typejava に設定します。
  7. Component versionlatest に設定します。
  8. アプリケーションに名前を付けます。
  9. Push after create チェックボックスを未選択にします。
  10. Finish をクリックします。

Console ビューが表示され、検証プロセスが表示されます。

新たに作成されたコンポーネントが、プロジェクト下の OpenShift Application Explorer ビューに表示されます。

5.6. OpenShift Application Explorer を使用したクラスターへのコンポーネントのデプロイ

CodeReady Studio で OpenShift Application Explorer を使用して、クラスターにコンポーネントをデプロイする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. プロジェクトを展開します。
  4. アプリケーションを展開します。
  5. componentPush を右クリックします。

    crs os push

    Console ビューが表示され、ファイル同期化のプロセスが表示されます。

5.7. OpenShift Application Explorer を使用した外部アクセス URL の定義

CodeReady Studio で OpenShift Application Explorer を使用して外部アクセス URL を定義する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. OpenShift Application Explorer を起動します。
  3. プロジェクトを展開します。
  4. アプリケーションを展開します。
  5. componentNewURL を右クリックします。

    crs os new url

    Create URL ウインドウが表示されます。

    crs os create url window
  6. URL に名前を付けます。
  7. Port の値を 8080 に設定します。
  8. Finish をクリックします。

    Console ビューが表示され、URL 作成のプロセスが表示されます。

  9. OpenShift Application Explorer で、componentPush を右クリックします。

    crs os push

    Console ビューが表示され、ファイル同期化のプロセスが表示されます。

新たに作成された URL がコンポーネント下の OpenShift Application Explorer ビューに表示されます。

5.8. OpenShift Application Explorer を使用したクラスターでのアプリケーションのデバッグ

CodeReady Studio で OpenShift Application Explorer を使用して、クラスターでアプリケーションをデバッグする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer ビューで MainVerticle.java (devfiles) または HttpApplication.java (S2I) ファイルを見つけ、ダブルクリックして開きます。
  3. 左側がルーラーになっている列をクリックし、ブレークポイントを設定します。

    crs os debugging breakpoint
  4. OpenShift Application Explorer を開きます。
  5. プロジェクトを展開します。
  6. アプリケーションを展開します。
  7. componentDebug を右クリックします。

    crs os debug

    Console ビューが表示されます。

  8. OpenShift Application Explorer で、コンポーネントを展開します。
  9. urlOpen in Browser を右クリックします。

    crc os open in browser

    Confirm Perspective Switch ウインドウが表示されます。

  10. Switch をクリックします。

    Debug Perspective ウィンドウが表示され、デバッグプロセスが表示されます。

第6章 CodeReady Studio の Quarkus ツールの基本

Quarkus は Kubernetes ネイティブのフルスタック Java フレームワークで、Java 仮想マシンとの作業を最適化することを目的としています。Quarkus は、Quarkus アプリケーション開発者向けのツールを提供します。Java アプリケーションおよびコンテナーイメージフットプリントのサイズを削減し、必要になるメモリー量を削減します。

前提条件

  • 最新バージョンの JBoss Tools がインストールされている。詳細は、「JBoss Tools Downloads」を参照してください。

6.1. 新しい Quarkus プロジェクトの作成

CodeReady Studio で新しい Quarkus プロジェクトを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs quarkus project wizard
  3. 検索フィールドに Quarkus と入力します。
  4. Quarkus Project を選択します。
  5. Next をクリックします。

    New Quarkus project ウインドウが表示されます。

    crs quarkus project creation
  6. 必要なプロジェクトタイプを選択します。
  7. プロジェクトに名前を付けます。
  8. プロジェクトの場所を選択します。
  9. Next をクリックします。

    Project type ウインドウが表示されます。

    crs quarkus default values
  10. デフォルト値が正しいことを確認します。
  11. Next をクリックします。

    Quarkus extensions ウインドウが表示されます。

    crs quarkus extensions selection
  12. プロジェクトに必要な Categories を選択します。

    選択したカテゴリーに使用可能なエクステンションが Extensions 列に表示されます。

  13. プロジェクトに必要な Extensions を選択します。

    エクステンションをダブルクリックして選択または選択解除します。選択したエクステンションが Selected 列に表示されます。

  14. Finish をクリックします。

新たに作成された Quarkus プロジェクトが Project Explorer ビューに表示されます。

6.2. Quarkus アプリケーションの実行

CodeReady Studio で Quarkus アプリケーションを実行する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. RunRun Configurations とクリックします。

    crs run configurations

    Run Configurations ウィンドウが表示されます。

  3. Quarkus Application まで下へスクロールします。

    crs quarkus new config
  4. Quarkus ApplicationNew Configuration を右クリックします。

    crs new quarkus configuration
  5. 設定に名前を付けます。
  6. Browse をクリックしてプロジェクトを見つけます。

    注記

    環境変数を Quarkus プロジェクトに追加できます。新しい環境変数を追加するには、Environmentadd とクリックし、名前と値を選択します。

    crs quarkus configuration environment variables
  7. Apply をクリックします。
  8. Run クリックします。

    Console ビューが表示されます。

アプリケーションは、ビルドプロセスの後に起動します。

6.3. Quarkus アプリケーションのデバッグ

CodeReady Studio で Quarkus アプリケーションをデバッグする方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. RunDebug Configurations とクリックします。

    crs run debug config

    Debug Configurations ウィンドウが表示されます。

    crs debug conf window
  3. Quarkus Application を展開します。
  4. 設定を選択します。
  5. Debug をクリックします。

    Console ビューが表示されます。

Quarkus アプリケーションが起動し、リモート JVM デバッグ設定に接続します。アプリケーションのソースファイルにブレークポイントを設定すると、ブレークポイントに到達した後に実行が自動的に停止します。

6.4. CodeReady Studio での言語サポートの使用

すべての Quarkus アプリケーションは、application.properties 設定ファイルを使用して設定されます。この設定ファイルの内容は、アプリケーションが使用している Quarkus エクステンションのセットに依存します。

Quarkus ツールには、コード補完、検証、およびドキュメントを提供するコンテンツアシストが含まれています。コード補完により、コードのステートメントを迅速に完了できます。ポップアップから複数の選択肢を利用することができます。この言語サポートは、Kubernetes、OpenShift、S2i、Docker プロパティー、MicroProfile REST Client プロパティー、および MicroProfile Health アーティファクトで使用できるようになりました。
MicroProfile REST Client プロパティーの言語サポートは、個別に有効にする必要があります。詳細は、「MicroProfile REST Client プロパティーの言語サポートの有効化」 を参照してください。

6.4.1. Quarkus のコンテンツアシストの使用

CodeReady Studio で Quarkus の application.properties コンテントアシストを使用する方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer を起動します。
  3. Quarkus projectsrc/main/resources を展開します。
  4. application.propertiesOpen WithGeneric Text Editor を右クリックします。

    crs open quarkus project in gen text editor

    Generic Text Editor ウインドウが表示されます。

  5. 空の行に移動します。
  6. Ctrl+Space を押してコード補完を実行します。

    コード補完のサジェスチョンが表示されます。マウスカーソルをサジェスチョンの上に移動し、ドキュメントを表示します。

    devstudio quarkus code completion1

    エディターで誤った値を入力すると、エラーの下に赤い波線が表示されます。

    devstudio quarkus code completion error

その他のリソース

6.4.2. MicroProfile REST Client プロパティーの言語サポートの有効化

MicroProfile REST Client プロパティーの言語サポートを有効にする方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer を起動します。
  3. Quarkus projectsrc/main/java を展開します。
  4. org.acmeNewOther を右クリックします。

    Select wizard ウインドウが表示されます。

    crs new file creation
  5. 検索フィールドに file と入力します。
  6. File を選択します。
  7. Next をクリックします。

    Create a new file resource ウインドウが表示されます。

    crs new dotjava file
  8. 新しいファイルに名前を付けます。
  9. Finish をクリックします。
  10. 新たに作成されたファイルに以下の内容を貼り付けます。

    package org.acme;
    
    import javax.ws.rs.GET;
    import javax.ws.rs.Path;
    import javax.ws.rs.core.Response;
    
    import org.eclipse.microprofile.rest.client.inject.RegisterRestClient;
    
    @RegisterRestClient
    public interface MyServiceClient {
    	@GET
        ("/greet")
        Response greet();
    }
  11. Ctrl+S キーを押して変更を保存します。

その他のリソース

第7章 CodeReady Studio の Hibernate Tools の基本

Hibernate Tools は、Hibernate バージョン 5 以前に関連するプロジェクトのツールのコレクションです。このツールは、Hibernate とのリバースエンジニアリング、コード生成、可視化、および対話を行う Eclipse プラグインを提供します。

7.1. 新規 JPA プロジェクトの作成

CodeReady Studio で新規 JPA プロジェクトを作成する方法を説明します。

前提条件

CodeReady Studio で新しい JPA プロジェクトを作成する前に、Sakila データベースサーバーを起動する必要があります。

  1. h2 バージョンの Sakila データベース をダウンロードします。
  2. runh2.sh ファイルが含まれるディレクトリーに移動します。
  3. runh2.sh ファイルを実行します。

    $ ./runh2.sh

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a Wizard ウインドウが表示されます。

    crs creating a jpa project
  3. 検索フィールドに JPA と入力します。
  4. JPA Project を選択します。
  5. Next をクリックします。

    New JPA Project ウインドウが表示されます。

    crs jpa project creation
  6. プロジェクトに名前を付けます。
  7. プロジェクトの場所を選択します。
  8. Target runtime フィールドで下矢印をクリックし、ランタイムサーバーを選択します。
  9. JPA version を 2.1 に設定します。
  10. Next をクリックします。

    Java ウィンドウが表示されます。

    crs creating jpa project
  11. ソースフォルダーを選択します。
  12. Next をクリックします。

    JPA Facet ウィンドウが表示されます。

    crs jpa facet
  13. Platform フィールドの下矢印をクリックし、Hibernate (JPA 2.1) を選択します。
  14. ユーザーライブラリーを追加するか、JPA Implementation TypeDisable Library Configuration に設定します。

    ユーザーライブラリーの設定方法の詳細は、「ライブラリーの追加」 を参照してください。

  15. Add connection をクリックします。

    Connection Profile ウインドウが表示されます。

    crs creating generic jdbc connection
  16. 検索フィールドに Generic と入力します。
  17. Generic JDBC を選択します。
  18. Name フィールドに Sakila と入力します。
  19. Next をクリックします。

    Specify a Driver and Connection Details ウィンドウが表示されます。

  20. New Driver Definition アイコンをクリックします。

    new driver definition crs

    New Driver Definition ウインドウが表示されます。

    crs specifying new driver definition
  21. Generic JDBC Driver を選択します。
  22. JAR List タブをクリックします。

    crs selecting sakila database
  23. Add JAR/Zip ボタンをクリックします。
  24. Sakila データベースの .jar ファイルを選択します。
  25. Properties タブをクリックします。

    crs properties window
  26. Connection URL フィールドに jdbc:h2:tcp://localhost/./sakila を追加します。
  27. Driver Class フィールドをクリックします。
  28. Driver Class フィールドの末尾にある、点 3 つのアイコンをクリックします。

    Available Classes from Jar List ウインドウが表示されます。

    crs class from jar list
  29. Browse for Class オプションを選択します。
  30. org.h2.Driver を選択します。
  31. OK をクリックします。
  32. User ID フィールドに sa と入力します。

    crs propertie window filled
  33. OKFinishFinish とクリックします。

新たに作成された JPA プロジェクトが Project Explorer ビューに表示されます。

7.2. ライブラリーの追加

CodeReady Studio で、Hibernate プロジェクトにライブラリーを追加する方法を説明します。

手順

  1. Hibernate ORM をダウンロードします。
  2. ファイルを展開します。
  3. CodeReady Studio を起動します。
  4. WindowPreferences をクリックします。

    crs preferences

    Preferences ウィンドウが表示されます。

    crs preferences user libraries
  5. 検索フィールドに Libraries と入力します。
  6. JavaUser Libraries を選択します。
  7. New ボタンをクリックします。

    New User Library ウィンドウが表示されます。

  8. ユーザーライブラリーに名前を付けます。
  9. OK をクリックします。
  10. 新しいユーザーライブラリーを選択します。

    crs select user libraries
  11. Add External JARs ボタンをクリックします。
  12. Hibernate ORM ファイルを展開したディレクトリーを選択します。
  13. /lib/required/ ディレクトリーに移動します。
  14. .jar ファイルを選択します。
  15. Open をクリックします。

    選択した .jar ファイルがユーザーライブラリーに表示されます。

    crs user libraries added
  16. Apply and Close をクリックします。

7.3. エンティティーからのテーブルの生成

CodeReady Studio で Hibernate プロジェクトのエンティティーからテーブルを生成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Project Explorer を開きます。
  3. JPA projectJPA ToolsGenerate Tables from Entities を右クリックします。

    crs generate tables from entities

    Generate Table from Entities ウィンドウが表示されます。

    crs generating tables from entities
  4. Use Console Configuration チェックボックスを選択します。
  5. Finish をクリックします。

7.4. Hibernate マッピングファイルの作成

Hibernate マッピングファイルは、オブジェクトがどのようにデータベーステーブルに関連するかを指定します。

CodeReady Studio で Hibernate マッピングファイルを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs creating hibernate xml mapping file
  3. 検索フィールドに Hibernate と入力します。
  4. Hibernate XML Mapping file (hbm.xml) を選択します。
  5. Next をクリックします。

    Create Hibernate XML Mapping file ウインドウが表示されます。

    crs hibernate xml mapping table creation
  6. Add Class ボタンをクリックしてクラスを追加します。
  7. Add Package ボタンをクリックしてパッケージを追加します。

    または、パッケージまたはクラスを選択せずに空の .hbm.xml ファイルを作成することもできます。

  8. depth control チェックボックスを選択し、クラスの選択時に使用される依存関係の深さを定義します。
  9. Next をクリックします。

    New Hibernate XML Mapping files ウインドウが表示されます。

    crs selecting parent directory for hibernate mapping file
  10. 親ディレクトリーを選択します。
  11. .hbm.xml ファイルに名前を付けます。
  12. Finish をクリックします。

7.5. Hibernate 設定ファイルの作成

リバースエンジニアリング、プロトタイプクエリー、または Hibernate Core の使用には、hibernate.properties または hibernate.cfg.xml ファイルが必要になります。CodeReady Studio には、設定ファイル hibernate.cfg.xml を生成するウィザードがあります。

CodeReady Studio で Hibernate 設定ファイルを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs creating hibernate config file
  3. 検索フィールドに Hibernate と入力します。
  4. Hibernate Configuration file (cfg.xml) を選択します。
  5. Next をクリックします。

    Create Hibernate Configuration file (cfg.xml) ウインドウが表示されます。

    crs selecting parent dir for hibernate config file
  6. 親ディレクトリーを選択します。
  7. Next をクリックします。

    Hibernate Configuration File(cfg.xml) ウインドウが表示されます。

    crs hibenate config file creation
  8. Database dialect フィールドの下矢印をクリックして、データベースを選択します。
  9. Driver class フィールドの下矢印をクリックして、ドライバーを選択します。
  10. Connection URL フィールドの下矢印をクリックし、URL を選択します。
  11. Finish をクリックします。

7.6. Hibernate コンソール設定ファイルの作成

コンソール設定ファイルには、Hibernate プラグインがどのように Hibernate を設定するかが記述されています。また、POJO や JDBC ドライバーなどのロードに必要な設定ファイルおよびクラスパスも記述されています。これは、クエリープロトタイピング、リバースエンジニアリング、およびコードの生成を使用するために必要です。プロジェクトごとに複数のコンソール設定を指定できますが、1 つの設定で十分です。

CodeReady Studio で Hibernate コンソール設定ファイルを作成する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs creating a hibernate console config
  3. 検索フィールドに Hibernate と入力します。
  4. Hibernate Console Configuration を選択します。
  5. Next をクリックします。

    Create Hibernate Console Configuration ウィンドウが表示されます。

    crs create hibernate console config
  6. 設定ファイルに名前を付けます。
  7. TypeCore に設定されていることを確認します。
  8. 正しい Hibernate version を選択します。
  9. Browse をクリックしてプロジェクトを見つけます。
  10. New をクリックして、新しい Database connection を設定します。

    New Connection Profile ウインドウが表示されます。

  11. Data Connection を選択するか、新たに作成します。
  12. Setup をクリックし、Property file を設定します。

    Setup property file ウインドウを表示します。

  13. Create new をクリックします。

    Create Hibernate Properties file (.properties) ウインドウが表示されます。

    crs create hibernate properties file
  14. 親ディレクトリーを選択します。
  15. .properties ファイルに名前を付けます。
  16. Finish をクリックします。
  17. Setup をクリックし、Configuration file を設定します。
  18. ターゲット .cfg.xml ファイルへのパスを選択します。

    Setup configuration file ウインドウが表示されます。

  19. Create new をクリックします。

    Create Hibernate Configuration file (cfg.xml) ウインドウが表示されます。

    crs selecting parent dir for hibernate config file
  20. 親ディレクトリーを選択します。
  21. Next をクリックします。

    Hibernate Configuration File(cfg.xml) ウインドウが表示されます。

    crs hibenate config file creation
  22. Database dialect フィールドの下矢印をクリックして、データベースを選択します。
  23. Driver class フィールドの下矢印をクリックして、ドライバーを選択します。
  24. Connection URL フィールドの下矢印をクリックし、URL を選択します。
  25. Finish をクリックします。

    Create Hibernate Console Configuration ウィンドウが表示されます。

    crs creation of console config
  26. データベースコネクションを sakila に設定します。
  27. Finish をクリックします。

7.7. Hibernate プロジェクト設定の編集

CodeReady Studio で Hibernate プロジェクトの設定を編集する方法を説明します。

手順

  1. CodeReady Studio を起動します。
  2. WindowShow ViewOther とクリックします。

    crs window show view other

    Show View ウインドウが表示されます。

    crs opening hibernate view
  3. 検索フィールドに Hibernate と入力します。
  4. Hibernate Configurations を選択します。
  5. Open をクリックします。

    Hibernate Configurations ビューが表示されます。

    crs editing hibernate config
  6. projectEdit Configuration を右クリックします。

    Edit Configuration ウインドウが表示されます。

    crs edit config view
  7. 設定を編集します。
  8. Apply をクリックします。
  9. OK をクリックします。

第8章 CodeReady Studio での Mobile Web Tools の基本

Mobile Web Tools は、モバイルデバイス向けに最適化された Web アプリケーションの作成を可能にする HTML5 Project ウィザードを提供します。HTML5 Project ウィザードは、CodeReady Studio ですべての新規 HTML5 Web アプリケーションを作成するための便利なウィザードです。このウィザードは、Maven archetype からの REST リソースを使用して、そのままデプロイできる HTML5 モバイルアプリケーションのサンプルを生成します。

組み込みエディターを使用してアプリケーションをカスタマイズでき、組み込みブラウザーでアプリケーションをデプロイおよび表示できます。

CodeReady Studio では、ユーザーが対話式の Web アプリケーションを作成できる Mobile Web パレットが提供されます。このパレットは、HTML5、jQuery Mobile‍、および Ionic タグなどの一般的な Web インターフェースフレームワーク機能を html ファイルに追加するドラッグアンドドロップウィジェットなど、幅広い機能を提供します。また、よりユーザーフレンドリーで効率的なアプリケーションを実現するための、PanelsPagesLists、および Buttons などのウィジェットも含まれています。

8.1. HTML5 プロジェクトの作成

HTML5 Project ウィザードは、Maven アーキタイプと、提供するプロジェクトおよびアプリケーション識別子を基にして、サンプルプロジェクトを生成します。Maven archetype バージョンは、ウィザードの最初のページにある Description フィールドに示されます。バージョンを変更できるため、ウィザード内でエンタープライズまたは非エンタープライズいずれかのターゲットランタイムを選択して、プロジェクトの見た目と依存関係も変更できます。

CodeReady Studio で HTML5 プロジェクトを作成する方法を説明します。

前提条件

  • 設定済みのサーバー。

    ローカルランタイムサーバーの設定およびアプリケーションのローカルランタイムサーバーへのデプロイメントに関する詳細は、「ローカルサーバーの設定」 を参照してください。

CodeReady Studio は、アプリケーションをデプロイするすべてのサーバーに対して設定する必要があります。これには、アプリケーションサーバーの場所およびタイプ、カスタム設定、カスタム管理設定などが含まれます。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs html5 wizard
  3. 検索フィールドに HTML5 と入力します。
  4. HTML5 Project を選択します。
  5. Next をクリックします。

    New Project Example ウィンドウが表示されます。

    crs creating an html5 project
  6. Target Runtime フィールドの下矢印をクリックします。
  7. サーバーを選択します。
  8. Next をクリックします。
  9. プロジェクトとパッケージに名前を付けます。
  10. プロジェクトの場所を選択します。
  11. Finish をクリックします。

    プロジェクトの生成には時間がかかる場合があります。

    New Project Example ウィンドウが表示されます。

  12. Finish をクリックします。

新たに作成されたプロジェクトが Project Explorer ビューに表示されます。

8.2. 新しい HTML5 jQuery Mobile ファイルの追加

HTML5 jQuery Mobile ファイルテンプレートは、ファイルの HTML ヘッダーに挿入される JavaScript および CSS ライブラリー参照で構成されます。このテンプレートは、jQuery Mobile ページのスケルトンや、ファイルの HTML ボディーの listview ウィジェットも挿入します。

既存のプロジェクトに新しい HTML5 jQuery Mobile ファイルを追加する方法を説明します。

前提条件

  • 設定済みのサーバー。

    ローカルランタイムサーバーの設定およびアプリケーションのローカルランタイムサーバーへのデプロイメントに関する詳細は、「ローカルサーバーの設定」 を参照してください。

CodeReady Studio は、アプリケーションをデプロイするすべてのサーバーに対して設定する必要があります。これには、アプリケーションサーバーの場所およびタイプ、カスタム設定、カスタム管理設定などが含まれます。

手順

  1. CodeReady Studio を起動します。
  2. Ctrl+N キーを押します。

    Select a wizard ウインドウが表示されます。

    crs html file wizard
  3. 検索フィールドに HTML と入力します。
  4. HTML File を選択します。
  5. Next をクリックします。

    New HTML File ウインドウが表示されます。

    crs naming html file
  6. ファイルの場所を選択します。
  7. ファイルに名前を付けます。
  8. Next をクリックします。

    Select HTML Template ウインドウが表示されます。

    crs selecting html template
  9. テンプレートを選択します。
  10. Finish をクリックします。

新たに作成された HTML ファイルが CodeReady Studio エディターに表示されます。

8.3. 新しいモバイルページの追加

既存の Web アプリケーションに新しい jQuery Mobile ページを追加する方法を説明します。

前提条件

手順

  1. CodeReady Studio を起動します。
  2. WindowShow viewOther とクリックします。

    crs window show view other

    Show View ウインドウが表示されます。

    crs selecting palette view
  3. 検索フィールドに Palette と入力します。
  4. Palette を選択します。
  5. Open をクリックします。

    Palette ビューが表示されます。

    crs palette view
  6. Page アイコンをクリックします。

    Insert Tag ウィンドウが表示されます。

    crs creating a page with palette
  7. Header に名前を付けます。
  8. Footer に名前を付けます。
  9. Finish をクリックします。

新たに追加されたページが CodeReady Studio エディターに表示されます。

注記

Palette ビューからウィジェットを選択して、同じワークフローを使用して Web アプリケーションのページをカスタマイズできます。

法律上の通知

Copyright © 2021 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.