目的
LibertyのJSF環境を構築して HelloWorld のような簡単なプログラムでテストします。
JSFプログラムの説明
EclipseでDynamic Web Projectが作成できているところからの作成手順です。
Bean classの作成
SessionBeanのclassを作成します。
- 右クリック > New > Class で選択
- Package: pdprof.jsf
- Name : HelloBean
- Finish ボタンをクリック
- classのアノテーションを追加
- message filed の追加
- Validation size の追加
- setter/getter メソッドの作成
HelloBean.java
package pdprof.jsf;
import java.io.Serializable;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;
import javax.validation.constraints.Size;
@ManagedBean
@SessionScoped
public class HelloBean implements Serializable {
@Size(min=3)
private String message = "Hello World!";
public String getMessage() {
System.out.println("HelloBean.gettMessage : << " + message);
return message;
}
public void setMessage(String message) {
System.out.println("HelloBean.setMessage : >> " + message);
this.message = message;
}
}
XHTMLの作成
XHTMLを新規に作成します。
- 右クリック > New > HTML File
- File Name : index.xhtml
- Next ボタンをクリック
- New Facelet Composition Page を選択
- Finishをクリック
多少は流用しつつbodyのところを変更する。
index.xhtml
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:ui="http://xmlns.jcp.org/jsf/facelets"
xmlns:h="http://xmlns.jcp.org/jsf/html"
xmlns:f="http://xmlns.jcp.org/jsf/core">
<body>
helloBean.message : <br />
#{helloBean.message}<br />
<hr />
<h:form>
Input Message (3 characters minimum): <br />
<h:inputText id="message" value="#{helloBean.message}" /><br />
<h:commandButton id="button" value="Send" action="index.xhtml" />
</h:form>
</body>
</html>
web.xml の作成（更新）
Webプロジェクト作成時にweb.xmlを作成していない場合には作成をして、更新をします。
作成方法は
- 右クリック > Java EE Tools > Generate Deployment Descriptor Stub
で web.xml が作成されます。
これに、Faces Servlet の servletとservlet-mappingを追加します。また welcome-file に index.xhtml も追加します。
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.1"
xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd">
<display-name>jsf</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.jsp</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>index.xhtml</welcome-file>
</welcome-file-list>
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.xhtml</url-pattern>
</servlet-mapping>
</web-app>
Libertyテスト環境
今回は tWAS でも動作するように、Java8, jsf-2.2, beanvalidation-1.1 で動かします。
server 構成は以下になります。
server.xml
<server description="new server">
<!-- Enable features -->
<featureManager>
<feature>jsf-2.2</feature>
<feature>beanValidation-1.1</feature>
<feature>localConnector-1.0</feature>
</featureManager>
<!-- To access this server from a remote client add a host attribute to the following element, e.g. host="*" -->
<httpEndpoint httpPort="9080" httpsPort="9443" id="defaultHttpEndpoint"/>
<!-- Automatically expand WAR files and EAR files -->
<applicationManager autoExpand="true"/>
<!-- Default SSL configuration enables trust for default certificates from the Java runtime -->
<ssl id="defaultSSLConfig" trustDefaultCerts="true"/>
<applicationMonitor updateTrigger="mbean"/>
<webApplication id="jsf" location="jsf.war" name="jsf"/>
</server>
Libertyテスト環境の自動構築
これまでの方法で既存環境に構成はかのうですが、環境をdockerで用意する方法です。
用意したGitレポジトリをクローンします。
git clone http://github.com/pdprof/jsf.git
cd jsf/jsf-docker
Libertyのイメージをビルドして開始します。
./setup-docker.sh
./start.sh
Libertyの起動を確認します。JSF にアクセスします。
index.xhtml で入力
アクセスしたindex.xhtmlでJSFをテストします。
Input Message に入力して、Send ボタンをクリックするとページが更新されます。
Helloと入力してSendした場合は
messages.log
[3/30/25, 13:59:53:126 UTC] 00000053 SystemOut O HelloBean.setMessage : >> Hello
[3/30/25, 13:59:53:129 UTC] 00000053 SystemOut O HelloBean.gettMessage : << Hello
[3/30/25, 13:59:53:130 UTC] 00000053 SystemOut O HelloBean.gettMessage : << Hello
のように HelloBeanのsetter/getter が動作しているのがログから分かります。
指定したSizeのValidationは2文字の Hi では
messages.log
[3/30/25, 14:02:40:023 UTC] 0000003f org.apache.myfaces.lifecycle.RenderResponseExecutor W There are some unhandled FacesMessages, this means not every FacesMessage had a chance to be rendered.
These unhandled FacesMessages are:
- j_id_3:message: size must be between 3 and 2147483647
とログ出力されて、setter/getter の動作は確認できません。
このValdationは MyFaces Bean Validation support enabled のメッセージで使えるか確認できます。
[3/30/25, 13:57:15:735 UTC] 00000042 org.apache.myfaces.util.ExternalSpecifications
I MyFaces Bean Validation support enabled
トラブルシューティング
毎度のことですが、よくつかう dockerコマンドを書いておきます。この文書でもpodman, dockerとまとまりがないですが、Linux では dockerがpodmanを呼び出すようになっていました。
docker ps # 動作中のContainer確認
docker logs -f jsf # ログ確認
docker restart jsf # 再起動
docker inspect jsf # container 確認
docker exec -it jsf bash # Container内状況確認
まとめ
Libertyの環境を構築して、JSFをテストしました。
参考
以下ページを参考にさせていただきました。ありがとうございます。