JSF & Java 實務隨手記: 標籤

f:convertDateTime 轉換時間格式

f:convertDateTime 通常會被夾在 h:inputText 或者 h:outputText 中，做為轉換日期時間之用。
最好用的屬性就是 pattern 用來指定日期時間格式，把本來的日期長整數，依我們所想要的格式顯示出來。當然，在上例中指出時區，可以更精準的顯示出當地時間。
在未使用 f:convertDateTime 之前 #{log.when}是表示毫秒的長整數

1367407097037

使用後則是

2013-05-01 07:42:20

很方便不是嗎？

JSF 頁面基本組成

JSF 的頁面基本上是一個 xhtml 檔。和一般 Html 檔類似，html 的namespace （什麼是namespace？）指出了這個xhtml 檔會使用哪些 jsf 元件。
在以下的例子中，我們看到該頁可能會用到 xhtml 基本的 html 標籤元素，f: ,h: , ui: 等基本的 JSF 標籤元素，以及 primefaces 的 p: 標籤元素。

在 <html></html> 標籤下夾了<h:head></h:head> 和<h:body></h:body>兩組標籤。
當然，<h:head></h:head> 中會夾著 title ,meta , link 的相關標籤。而<h:body></h:body>內夾的就如同 html 的 body 一樣是網頁的主體。
了解了這個主要架構後，接下來學習各個 jsf 的 tag 使用會比較清楚。

h:outputText 單純的文字輸出

<h:outputText> 是最常用到的文字輸出標籤之一。雖然在 JSF 2.0 不一定要用它才能輸出文字，但是它還是有一些有用的屬性方便我們做各種變化輸出。
比較常會用到屬性列表如下：
h:outputText 屬性

屬性	說明
value	實際上輸出的文字
rendered	輸出的條件，當整個運算為true 時會輸出；為 false 時不會輸出。
id	元件的 id 。ajax 或 css 操作元件時會使用。
style	css 樣式。直接使用css 樣式
styleClass	css 樣式類別。
escape	是否要避掉 XML 或 HTML 敏感的字元。如（< , > ）等。
title	（滑鼠滑過時）提示用的 title 和 html 的 title 相同。

以下的程式我們就來示範這些屬性的使用。
示範程式：
Java Managed Bean：

/**
 * 示範 outputText 用
 */
package jason.blogger.jsf;

import javax.faces.bean.ManagedBean;

/**
 * @author jason 2013/5/13
 */
@ManagedBean
public class Person
{
 private String firstName;
 private String lastName;
 private String tag;

 public Person()
 {
  super();
  firstName="三";
  lastName="張";
  tag="
";
 }

 public String getFirstName()
 {
  return firstName;
 }

 public void setFirstName(String firstName)
 {
  this.firstName = firstName;
 }

 public String getLastName()
 {
  return lastName;
 }

 public void setLastName(String lastName)
 {
  this.lastName = lastName;
 }

 public String getTag()
 {
  return tag;
 }

 public void setTag(String tag)
 {
  this.tag = tag;
 }
}

xhtml ：

CSS:

@CHARSET "UTF-8";
.name
{
  background:pink;
}

#first
{
 color:yellow;
}

輸出結果：

2013年5月11日 星期六

f:convertDateTime 轉換時間格式

JSF 頁面基本組成

h:outputText 單純的文字輸出

2013年5月11日星期六