JSF1教程.doc

JSF标签系列教程(一) JSF 标准标签日期：2008-07-05来源： 作者：志伟JSF标签系列教程(一) JSF 标准标签JSF提供了标准的HTML Renderer Kit，可以让您搭配JSF元件输出HTML文件，标准的HTML Renderer Kit主要包括了几个类别：输出（Outputs） 其名称以output作为开头，作用为输出指定的讯息或绑定值。输入（Inputs） 其名称以input作为开头，其作用为提供使用者输入栏位。命令（Commands） 其名称以command作为开头，其作用为提供命令或连结按钮。选择（Selections） 其名称以select作为开头，其作用为提供使用者选项的选取。其它 包括了form、message、messages、graphicImage等等未分类的标籤。JSF标准HTML标籤包括了几个共通的属性，整理如下：属性名称适用说明id所有元件可指定id名称，以让其它标签或元件參考binding所有元件綁定至UIComponentrendered所有元件是否显示元件styleClass所有元件设定Cascading stylesheet (CSS)value输入、输出、命令元件设定值或绑定至指定的值valueChangeListener输入元件设定值变事件处理者converter输入、输出元件设定转换器validator输入元件设定验证器required输入元件是否验证必填栏位immediate输入、命令元件是否为立即事件除了共通的属性之外，您还可以在某些元件上设定标籤HTML 4.01的属性，像是size、alt、width等属性，或者是设定DHTML事件属性，例如onchange、onclick等等。除了JSF的标准HTML标籤之外，您还需要一些标准核心标籤，这些标籤是独立于Renderer Kit的，JSF并不限制在HTML输出表示层，核心标籤可以搭配其它的Renderer Kit来使用。详细的HTML标籤或核心标籤的使用与属性说明可以查询 Tag Library Documentation 文件JSF标签系列教程(二) JSF 输出标签输出类的标签包括了outputLabel、outputLink、outputFormat与 outputText，分别举例说明如下：outputLabel产生 HTML标签，使用for属性指定元件的client ID，例如：这会产生像是以下的标签：outputLink产生 HTML标签，例如： 你可搭配帮链接加上参数，所有的参数都会变成 name=value 的型态附加在连结后。value所指定的内容也可以是JSF EL绑定。outputFormat产生指定的文字讯息，可以搭配来设定讯息的参数以格式化文字讯息，例如： 如果您的perties包括以下的内容：welcomeText=0, Your name is 1.则0与1会被取代为设定的文字，最后显示的文字会是：Hello, Your name is Guest.另一个使用的方法则是： outputText简单的显示指定的值或绑定的讯息，例如：JSF标签系列教程(三) JSF 输入标签输入类标签包括了inputText、inputTextarea、inputSecret、 inputHidden，分别举例说明如下：inputText显示单行输入栏位，即输出 HTML标签，其type属性设定为text，例如：inputTextarea显示多行输入文字区域，即输出 HTML标签，例如：inputSecret显示密码输入栏位，即输出 HTML标签，其type属性设定为password，例如：您可以设定redisplay属性以决定是否要显示密码栏位的值，预设是false。inputHidden隐藏栏位，即输出 HTML标签，其type属性设定为hidden，隐藏栏位的值用于保留一些讯息于客户端，以在下一次发送表单时一併送出，例如：JSF标签系列教程(四) JSF命令标签JSF命令类标签包括commandButton与commandLink，其主要作用在于提供一个命令按钮或连结，以下举例说明：commandButton显示一个命令按钮，即输出 HTML标签，其type属性可以设定为button、submit或reset，预设是submit，按下按钮会触发 javax.faces.event.ActionEvent，使用例子如下：您可以设定image属性，指定图片的URL，设定了image属性的话，标签的type属性会被设定为image，例如：commandLink产生超连结，会输出 HTML标签，而href属性会有#，而onclick属性会含有一段JavaScript程式，这个JavaScript的目的是按下连结后自动提交表单，具体来说其作用就像按钮，但外观却是超连结，包括在本体部份的内容都会成为超连结的一部份，一个使用的例子如下：产生的HTML输出范例如下：Submit如果搭配来使用，则所设定的参数会被当作请求参数一併送出，例如： JSF标签系列教程(五) JSF选择标签JSF选择标签(一)JSF CheckBox,JSF List,JSF Radio,JSF Menu日期：2008-07-05来源： 作者：志伟JSF标签系列教程(五) JSF选择标签。选择类的标签可略分为单选标签与多选标签，依外型的不同可以分为单选按钮（JSF Radio）、复选框（JSF CheckBox）、列表框（JSF ListBox）与菜单框（JSF Menu），以下分别先作简单的说明。在视图上呈现一个核取方块，例如：我同意 value所绑定的属性必须接受与传回boolean型态。这个元件在网页上呈现的外观如下：、这三个标签的作用，是让使用者从其所提供的选项中选择一个项目，所不同的就是其外观上的差别，例如： value所绑定的属性可以接受字串以外的型态或是自订型态，但记得如果是必须转换的型态或自订型态，必须搭配 标准转换器 或 自订转换器 来转换为物件，的外观如下：您也可以设定layout属性，可设定的属性是lineDirection、pageDirection，预设是lineDirection，也就是由左到右来排列选项，如果设定为pageDirection，则是由上至下排列选项，例如设定为： 则外观如下：、的设定方法类似于，以下分别列出、的外观：、JSF标签系列教程(五) JSF选择标签JSF选择标签(二)JSF CheckBox,JSF List,JSF Radio,JSF Menu日期：2008-07-05来源： 作者：志伟这三个标签提供使用者複选项目的功能，一个例子如下： value所绑定的属性必须是阵列或集合（Collection）物件，在这个例子中所使用的是boolean阵列，例如：UserBean.javapackage onlyfun.caterpillar;public class UserBean private boolean preferColors; public boolean getPreferColors() return preferColors; public void setPreferColors(boolean preferColors) this.preferColors = preferColors; .如果是其它型态的物件，必要时必须搭配转换器（Converter）进行字串与物件之间的转换。下图是的外观，这是将layout设定为pageDirection的外观：的设定方法类似，其外观如下：在不同的浏览器中会有不同的外观，在Mozilla Firefox中是这样的：在Internet Explorer則是这样的：JSF标签系列教程(六) JSF选择标签选择类标签可以搭配或标签来设定选项，例如：itemLabel属性设定显示在网页上的文字，itemValue设定发送至伺服端时的值，itemDescription 设定文字描述，它只作用于一些工具程式，对HTML没有什麽影响，itemDisabled设定是否选项是否作用，这些属性也都可以使用JSF Expression Language来绑定至一个值。也可以使用value来绑定一个传回javax.faces.model.SelectItem的方法，例如：则绑定的Bean上必须提供下面这个方法：. public SelectItem getSex() return new SelectItem(男); .如果要一次提供多个选项，则可以使用，它的value绑定至一个提供传回SelectItem?的阵列、集合，或者是Map物件的方法，例如： JSF标签系列教程(六) JSF选择标签2JSF选择标签(二)日期：2008-07-05来源： 作者：志伟这个例子中的value绑定至cationItems，其内容如下： . private SelectItem educationItems; public SelectItem getEducationItems() if(educationItems = null) educationItems = new SelectItem3; educationItems0 = new SelectItem(高中, 高中); educationItems1 = new SelectItem(大学, 大学); educationItems2 = new SelectItem(研究所以上, 研究所以上); return educationItems; .在这个例子中，SelectItem的第一个建构参数用以设定value，而第二个参数用以设定label，SelectItem还提供有数个建构函式，记得可以参考一下线上API文件。您也可以提供一个传回Map物件的方法，Map的key-value会分别作为选项的label-value，例如： 您要提供下面的程式来搭配上面这个例子：. private Map preferColor