検索
サポートコンソール開発者トライアルの開始お問い合わせ

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

download PDF
Red Hat CodeReady Studio 12.21.3

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

概要

本書のトピックでは、開発を効率的に進めるために 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. Window → Perspective → Open Perspective → Other とクリックします。

    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. Remotes → Create 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. branches → Remote Tracking の下で、master → Create 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 の branches → Local の下の Git 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. Encoding を Default (ISO-8859-1) に設定します。

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

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

    crs terminal

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

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

マージの競合を回避するには、特に共有リポジトリーで作業している場合は、変更をマージする前にローカルリポジトリーを更新してください。
ローカルリポジトリーを更新するには、リモートリポジトリーから変更を取得し、それらをローカルリポジトリーにマージします。

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。

  3. repository → Pull と右クリックします。

    crs pull

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

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

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

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

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

手順

  1. CodeReady Studio を起動します。
  2. Git Perspective を開きます。

  3. repository → Commit と右クリックします。

    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> エントリーが含まれ、aggregator pom とも呼ばれます。

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

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

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

手順

  1. CodeReady Studio を起動します。

  2. Window → Show View → Other とクリックします。

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

    crs pe explorer view
  3. 検索フィールドに Project Explorer と入力します。
  4. プロジェクトエクスプローラーを選択します。

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

    プロジェクトエクスプローラービューが表示されます。

    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. Packaging を pom、jar、または war に設定します。
  15. Finish をクリックします。

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

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

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

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

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

手順

  1. CodeReady Studio を起動します。

  2. File → Import とクリックします。

    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. プロジェクトをワーキングセットに追加 チェックボックスをオンにします。
  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 リポジトリー ビューに表示されます。

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. Packaging を pom、jar、または war に設定します。

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

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

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

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

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

前提条件

手順

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

  3. Maven の project → Maven → Add 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. project → Configure → Convert 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. Window → Preferences をクリックします。

    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. project → Run as → Run 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. Window → Preferences をクリックします。

    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. Window → Preferences をクリックします。

    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. Window → Show View → Other とクリックします。

    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 ビューの設定 を参照してください。

前提条件

  • 実行中の OpenShift クラスター。

5.1. OpenShift Application Explorer ビューの設定

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

手順

  1. CodeReady Studio を起動します。

  2. Window → Show View → Other とクリックします。

    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. OpenShift API URL を URL フィールドに貼り付けます。

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

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

5.3. ブラウザーベースのトークンの取得を使用した OpenShift クラスターへの接続

ユーザー名とパスワード、またはトークンを OpenShift Application Explorer に提供する代わりに、ブラウザーベースのトークンを取得して、OpenShift クラスターにログインすることができます。ログインコマンドを貼り付けるか、トークンを取得する場合は 2 つのログインオプションがあります。

5.3.1. login コマンドの貼り付け

手順

  1. OpenShift API URL を 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 の場合、ログインコマンドはクリップボードに自動的にコピーされます。

5.3.2. トークンの取得

手順

  1. OpenShift API URL を 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.4. 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 がブートストラップされました。

    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.5. devfile に基づくアプリケーションのビルド

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

手順

  1. CodeReady Studio を起動します。

  2. Ctrl+N キーを押します。

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

    crs create empty project in pe 1
  3. General → Project を選択します。

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

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

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

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

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

  8. OpenShift Application Explorer を起動します。

  9. OpenShift Application Explorer → New → Project の任意の場所をクリックします。

    crs os project

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

    crs os new project window
  10. プロジェクトに名前を付けます。

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

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

  12. ターゲットの Project → New → Component を右クリックします。

    crs os new component

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

    crs devfile component type

  13. プロジェクトに名前を付けます。
  14. Browse をクリックして Eclipse Project を選択します。
  15. Component type を java-vertx に設定します。
  16. Project starter を java-vertx に設定します。
  17. アプリケーションに名前を付けます。
  18. Push after create チェックボックスを未選択にします。

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

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

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

devfile をベースとするアプリケーションがビルドされます。

5.5.1. devfile レジストリーの管理

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

5.5.1.1. devfile レジストリーの追加

前提条件

  • 実行中の OpenShift クラスター。

手順

  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 レジストリーが OpenShift Application Explorer ビューの Devfile registries の下に表示されます。

5.5.1.2. devfile レジストリーの削除

前提条件

  • 実行中の OpenShift クラスター。

手順

  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 レジストリーのノードを右クリックし、delete をクリックします。

      crs delete devfile registry

これで、devfile レジストリーが削除されました。

5.5.1.3. devfile レジストリーの編集

前提条件

  • 実行中の OpenShift クラスター。

手順

  • devfile レジストリーを編集するには、YAML エディターを使用します。YAML エディターは、構文検証およびコンテンツアシストを提供します。
5.5.1.4. devfile レジストリーからのコンポーネントの作成

コンポーネントタイプまたはスタータープロジェクトの devfile レジストリーから新規コンポーネントを作成できます。

前提条件

  • 既存の Eclipse プロジェクト。
  • 既存の OpenShift プロジェクト。
  • OpenShift クラスターに接続している。

手順

  1. Devfile レジストリー ノードで devfile レジストリーを展開します。

  2. コンポーネントの種類またはスタータープロジェクトを右クリックし、Project → New → Component をクリックします。

    crs creating a component for devfile registry

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

    crs create devfile registry component
  3. コンポーネントに名前を付けます。
  4. Browse をクリックして Eclipse プロジェクトを選択します。
  5. Component タイプを選択します。
  6. プロジェクトのスターターを選択します。
  7. アプリケーションに名前を付けます。
  8. Finish をクリックします。

新規コンポーネントは devfile レジストリーから作成されます。

関連情報

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

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

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

手順

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

  5. component → Push を右クリックします。

    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. component → New → URL を右クリックします。

    crs os new url

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

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

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

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

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

    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) ファイルを見つけ、ダブルクリックして開きます。

  3. 左側がルーラーになっている列をクリックし、ブレークポイントを設定します。

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

  7. component → Debug を右クリックします。

    crs os debug

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

  8. OpenShift Application Explorer で、コンポーネントを展開します。

  9. url → Open in Browser を右クリックします。

    crc os open in browser

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

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

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

5.9. OpenShift Application Explorer を使用したアプリケーションサービスの作成

OpenShift でクラウドネイティブアプリケーションを開発する際に Operator を使用してサービスを作成します。

前提条件

  • クラスターへのインストールされた Operator。
    Operator のインストールについての詳細は、Adding Operators to a cluster を参照してください。

手順

  1. OpenShift Application Explorer ビューで、アプリケーションを右クリックします。

    crs new service

  2. New → Service を選択します。

    crs create service

    Create service ビューが表示されます。

  3. サービスの名前を入力します。
  4. Service ドロップダウンメニューから、クラスターにインストールされている Operator からサービスを選択します。
  5. Type ドロップダウンメニューから、デプロイメントのタイプを選択します。

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

    kafkacluster

新たに作成されたサービスが OpenShift Application Explorer ビューに表示されます。

第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. Quarkus ストリームを選択します。
  7. プロジェクトの種類を選択します。
  8. プロジェクトに名前を付けます。
  9. プロジェクトの場所を選択します。

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

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

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

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

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

    crs quarkus extensions selection

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

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

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

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

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

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

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

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

手順

  1. CodeReady Studio を起動します。

  2. Run → Run Configurations とクリックします。

    crs run configurations

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

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

    crs quarkus new config

  4. Quarkus Application → New Configuration を右クリックします。

    crs new quarkus configuration
  5. 設定に名前を付けます。

  6. Browse をクリックしてプロジェクトを見つけます。

    注記

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

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

  8. Run クリックします。

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

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

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

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

手順

  1. CodeReady Studio を起動します。

  2. Run → Debug 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、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 project → src/main/resources を展開します。

  4. application.properties → Open With → Generic 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 project → src/main/java を展開します。

  4. org.acme → New → Other を右クリックします。

    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. 新しい Jakarta Persistence プロジェクトの作成

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

前提条件

  • Sakila データベースサーバーが起動している。
    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 Type を Disable 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. jdbc:h2:tcp://localhost/./sakila を Connection URL フィールドに追加します。
  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. OK → Finish → Finish とクリックします。

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

7.2. ライブラリーの追加

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

手順

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

  4. Window → Preferences をクリックします。

    crs preferences

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

    crs preferences user libraries
  5. 検索フィールドに Libraries と入力します。
  6. Java で User 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 project → JPA Tools → Generate 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. Type が Core に設定されていることを確認します。
  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. Window → Show View → Other とクリックします。

    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. project → Edit Configuration を右クリックします。

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

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

7.8. Hibernate ランタイム実装の設定

Hibernate 設定ページでランタイム実装を有効または無効にできます。

以下のセクションでは、ランタイムの設定方法を説明します。

手順

  1. Window → Preferences をクリックします。

    設定ページが開きます。

    crs hibernate preferences page
  2. 検索フィールドに Hibernate と入力します。
  3. Hibernate を選択します。

チェックを入れて Hibernate プロジェクトのランタイムを無効にするか、チェックを解除します。

第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 ファイルに追加するドラッグアンドドロップウィジェットなど、幅広い機能を提供します。また、よりユーザーフレンドリーで効率的なアプリケーションを実現するための、Panels、Pages、Lists、および 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. Window → Show view → Other とクリックします。

    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 アプリケーションのページをカスタマイズできます。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

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

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.