Apache的安装见前文

PHP

1. 下载php-4.4.7.tar.gz，解压
2. ./configure --with-apxs2=$APACHE_HOME/bin/apxs
3. make & make install
4. cp php.ini-dist &PHP_HOME/etc/php.ini

DokuWiki

1. 下载dokuwiki-2006-11-06.tgz，解压
2. 为apache添加rewrite模块：
   cd $APACHE_HOME/modules/mappers
   $APACHE_HOME/bin/apxs -i -a -c mod_rewrite.c
3. 检查httpd.conf中是否已经加入：LoadModule rewrite_module libexec/mod_rewrite.so
4. 配置apache的httpd.conf
   
   Alias /wiki "/local/xsun/servers/dokuwiki"
   <Directory "$DokuWiki_HOME">
   Allow from all 
   
   AddType application/x-httpd-php .php .phtml
   AddType application/x-httpd-php-source .phps
   RewriteEngine on
   
   RewriteBase /wiki
   
   RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
   RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
   RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
   RewriteRule ^$                        doku.php  [L]
   RewriteCond %{REQUEST_FILENAME}       !-f
   RewriteCond %{REQUEST_FILENAME}       !-d
   RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
   RewriteRule ^index.php$               doku.php
   php_value auto_prepend_file "$DokuWiki_HOME/prepend.php"
   </Directory>
5. $APACHE_HOME/bin/apachectl start

DokuWiki 安全配置

 $conf['savedir'] = '/local/xsun/wiki/data';
@include(DOKU_CONF.'local.protected.php');

users.auth.php:
test:61e7250f72098cf2602541ffbaf66e59:LALALA:pepsixp@gmail.com:admin,user

acl.auth.php:
*               @ALL          1
*               @user         8

Hibernate Annotation 配置的注意点：

• 需要映射字段的@Column属性设为insertable = false, updatable = false，
• 不产生列重复的异常 
• 在hql解析的时候，自动合并相同的列(参考)
• 类必须implements Serializable，不然会抛ClassCaseException(郁闷4个小时 -_-!)

select  s from ScopeProjection s  left   join fetch s.overridewhere s.hubsite=? ands.companyabbr=?

1. mkdir /etc/svn/repos1
2. svnadmin create /etc/svn/repos1
3. svn import file:///etc/svn/repos1  --message "init" // 导入当前目录下所以文件
   svn import /local/mydir/ file:///etc/svn/repos1  --message "init" // 导入指定目录下所以文件

查看

• svn list --verbose file:///etc/svn/repos1/
• svnlook info /etc/svn/repos1/
• svnlook tree /etc/svn/repos1/ --show-ids

Apache权限控制

LoadModule dav_svn_module     modules/mod_dav_svn.so
LoadModule authz_svn_module   modules/mod_authz_svn.so
<Location /svn/>
DAV svn
SVNParentPath /etc/svn/repos1
SVNListParentPath on

AuthType Basic
AuthName "MY SVN Repository"
AuthUserFile /etc/svn/repos1/passwd.conf
AuthzSVNAccessFile /etc/svn/repos1/authz.conf
Require vaild-user
</Location>

[groups]
group1 = user1
group2 = user1,user2

[/]
* = r

[project1:/path1]
@group1 = rw

[project1:/path2]
@group2 = rw

取出：svn co file:///etc/svn/report1

另外需要修改两个地方，不然无法提交修改的文件：

1. chown -R sysuser:sysuser /etc/svn/report1
   chmod -R 700 /etc/svn/report1
2. 在${apache}/conf/httpd.conf中找到：
   User daemon
   Group daemon
   改为
   User sysuser
   Group sysuser
   以root用户启动apache后，自动切换到sysuser身份运行

Apache

1. 下载httpd-2.2.3.tar.gz，解压
2. 检查path是否加入了：/usr/ccs/bin，这是我make报错的根源，之后就一马平川了
3. $ ./configure --enable-dav --enable-so --prefix=/usr/local/apache2/
4. $ make;make install
5. 修改/usr/local/apache2/conf/httpd.conf中的ServerName的配置，写上服务器的IP地址和端口号，例如ServerName  12.34.56.78:80
6. 进入bin目录启动(需要root)，# ./apachectl start
7. 打开浏览器http://ip_address/，等待测试页"It works!"的出现 :_)

Subversion

1. 下载neon-0.26.2.tar.gz，解压
2. $ ./configure --prefix=/usr/local/neon; make; make install
3. 下载subversion-1.4.2.tar.gz，解压
4. $ ./configure --prefix=/usr/local/subversion --with-apxs=/usr/local/apache2/bin/apxs --with-apr=/usr/local/apache2 --with-apr-util=/usr/local/apache2 --with-neon=/usr/local/neon --with-ssl --with-zlib
5. $ make;make install
6. 修改apache配置文件httpd.conf：
   LoadModule dav_svn_module modules/mod_dav_svn.so 
   LoadModule authz_svn_module modules/mod_authz_svn.so 
   <Location /svn>
   DAV svn 
   SVNParentPath /home/svnroot/
   </Location>
7. 创建仓库：
   $ mkdir /home/svnroot/
   $ cd /usr/local/subversion/bin
   $ ./svnadmin create /home/svnroot/test
   $ ./svn import /home/user/import file:///home/svnroot/test –m "import files test"
8. 重启Apache
   $ ./usr/local/apache2/bin/apachectl restart
   打开浏览器：http://localhost/svn/test ，应该能看到些什么东西

1. 激活root用户：
   sudo passwd root
2. 修改源：
   sudo gedit /etc/apt/sources.list
   删除所有内容并添加如下信息(江苏省常州市电信)：
   deb http://ubuntu.cn99.com/ubuntu/ edgy main restricted universe multiverse
   deb http://ubuntu.cn99.com/ubuntu/ edgy-security main restricted universe multiverse
   deb http://ubuntu.cn99.com/ubuntu/ edgy-updates main restricted universe multiverse
   deb http://ubuntu.cn99.com/ubuntu/ edgy-proposed main restricted universe multiverse
   deb http://ubuntu.cn99.com/ubuntu/ edgy-backports main restricted universe multiverse
   deb http://ubuntu.cn99.com/ubuntu-cn/ edgy main restricted universe multiverse
3. 升级系统：
   sudo apt-get update
   sudo apt-get dist-upgrade
4. 设置本地local环境：
   sudo dpkg-reconfigure locales
5. 安装中文语言支持:
   do apt-get install language-pack-gnome-zh language-pack-gnome-zh-base language-pack-zh language-pack-zh-base language-support-zh
   
6. 安装中文字体：
   sudo apt-get install ttf-arphic-ukai ttf-arphic-uming
7. 安装编译环境:
   sudo apt-get install build-essential
8. 更改 GRUB 菜单内开机系统的预设值
   sudo vi /boot/grub/menu.lst
   修改 ... default 0 ...
   

参数－在macro指令中可以在宏变量之后定义参数
例二：
<#macro greet person>
  <font size="+2">Hello ${person}!</font>
</#macro>
使用：<@greet person="Fred"/> and <@greet person="Batman"/>
结果： <font size="+2">Hello Fred!</font> and <font size="+2">Hello Batman!</font>

macro可以有多个参数，参数的次序是无关的，在macro指令中只能使用定义的参数，并且必须对所有参数赋值，可以在定义参数时指定缺省值：

<#macro greet person color="black">
  <font size="+2" color="${color}">Hello ${person}!</font>
</#macro> 

在自定义指令嵌套内容：模板片断中使用<#nested>指令

<#macro border>
  <table border=4 cellspacing=0 cellpadding=4><tr><td>
    <#nested>
  </tr></td></table>
</#macro>

使用：<@border>The bordered text</@border>
结果：

<table border=4 cellspacing=0 cellpadding=4>
<tr><td>The bordered text
</tr></td></table>

<#nested>指令可以被多次调用：

<#macro do_thrice>
  <#nested>
  <#nested>
  <#nested>
</#macro>

使用：
<@do_thrice>Anything.</@do_thrice> 
结果：
Anything.
Anything.
Anything.

注意：嵌套内容是无法访问到macro中的局部变量的。
例如：

<#macro repeat count>
  <#local y = "test">
  <#list 1..count as x>
    ${y} ${count}/${x}: <#nested>
  </#list>
</#macro>
<@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>

结果：
test 3/1: ? ? ?
test 3/2: ? ? ?
test 3/3: ? ? ?

下面是一个嵌套使用自定义指令的例子：

<@border>
  <ul>
  <@do_thrice>
    <li><@greet person="Joe"/>
  </@do_thrice>
  </ul>
</@border> 

结果：

<table border=4 cellspacing=0 cellpadding=4><tr><td>
 <ul>
 <li><font size="+2">Hello Joe!</font>
 <li><font size="+2">Hello Joe!</font>
 <li><font size="+2">Hello Joe!</font>
 </ul>
</tr></td></table>  

在macro中使用循环变量－作为nested指令的参数传递循环变量的实际值，而在调用用户定义指令时，在<@…>开始标记的参数后面指定循环变量的名字：

<#macro repeat count>
  <#list 1..count as x>
    <#nested x, x/2, x==count>
  </#list>
</#macro>
<@repeat count=4 ; c, halfc, last>
  ${c}. ${halfc}<#if last> Last!</#if>
/@repeat

 结果：
1. 0.5
2. 1
3. 1.5
4. 2 Last!

注意：循环变量和用户定义指令开始标记指定的数目可以不同，调用时少指定循环变量，则多指定的值不可见，调用时多指定循环变量，多余的循环变量不会被创建。

模板中的变量，有三种类型：
1.) plain(全局)变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换
2.) 局部变量：在macro中有效，使用local指令创建和替换
3.) 循环变量：只能存在于指令的嵌套内容，由指令(如list)自动创建；宏的参数是局部变量，而不是循环变量

用assign指令创建和替换的例子：

<#assign x = 1>  <#-- create variable x -->
${x}
<#assign x = x + 3> <#-- replace variable x -->
${x}  

结果：
1
4

局部变量隐藏(而不是覆盖)同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子：

<#assign x = "plain">
1. ${x}  <#-- we see the plain var. here -->
<@test/>
6. ${x}  <#-- the value of plain var. was not changed -->
<#list ["loop"] as x>
    7. ${x}  <#-- now the loop var. hides the plain var. -->
    <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->
    8. ${x}  <#-- it still hides the plain var. -->
</#list>
9. ${x}  <#-- the new value of plain var. -->
 
<#macro test>
  2. ${x}  <#-- we still see the plain var. here -->
  <#local x = "local">
  3. ${x}  <#-- now the local var. hides it -->
  <#list ["loop"] as x>
    4. ${x}  <#-- now the loop var. hides the local var. -->
  </#list>
  5. ${x}  <#-- now we see the local var. again -->
</#macro>  

结果：
1. plain
  2. plain
  3. local
    4. loop
  5. local
6. plain
    7. loop
    8. loop
9. plain2

内部循环变量隐藏同名的外部循环变量，例如：

<#list ["loop 1"] as x>
  ${x}
  <#list ["loop 2"] as x>
    ${x}
    <#list ["loop 3"] as x>
      ${x}
    </#list>
    ${x}
  </#list>
  ${x}
</#list>

结果：
loop 1
    loop 2
      loop 3
    loop 2
  loop 1

模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据模型中的user的值是Big Joe：

<#assign user = "Joe Hider">
${user}          <#-- prints: Joe Hider -->
${.globals.user} <#-- prints: Big Joe -->  

命名(namespaces)空间－通常情况，只使用一个命名空间，称为主命名空间(main namespace)，但你是不会意识到这些的；为了创建可重用的macro、transforms或其它变量的集合(通常称库)，必须使用多命名空间，为了防止同名冲突。

首先创建一个库(假设保存在lib/my_test.ftl中)：

<#macro copyright date>
  <p>Copyright (C) ${date} Julia Smith. All rights reserved.
  <br>Email: ${mail}</p>
</#macro>  
<#assign mail = "jsmith@acme.com"> 

使用import指令导入库到模板中，Freemarker会为导入的库创建新的命名空间，并可以通过import指令中指定的hash(散列)变量访问库中的变量：

<#import "/lib/my_test.ftl" as my>
<#assign mail="fred@acme.com">
<@my.copyright date="1999-2002"/>
${my.mail}
${mail}  

结果：

<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.
  <br>Email: jsmith@acme.com</p>
jsmith@acme.com
fred@acme.com  

上面的例子中使用的两个同名变量并没有冲突，因为它们位于不同的命名空间

可以使用assign指令在导入的命名空间中创建或替代变量：

<#import "/lib/my_test.ftl" as my>
${my.mail}
<#assign mail="jsmith@other.com" in my>
${my.mail}  

结果：
jsmith@acme.com
jsmith@other.com 

数据模型中的变量任何地方都可见，也包括不同的命名空间，下面修改了刚才创建的库：

<#macro copyright date>
  <p>Copyright (C) ${date} ${user}. All rights reserved.</p>
</#macro>
<#assign mail = "${user}@acme.com">   

假设数据模型中的user变量的值是Fred：

<#import "/lib/my_test.ftl" as my>
<@my.copyright date="1999-2002"/>
${my.mail}

 结果：
 <p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>
Fred@acme.com 


参考：   chenyun'blog - FreeMarker设计指南
            FreeMarker  in sourceforge.net

<html>
<head>
  <title>Welcome!</title>
</head>
<body>
  <h1>Welcome ${user}!</h1>
  <p>Our latest product:
  <a href="${latestProduct.url}">${latestProduct.name}</a>!
</body>
</html>  

上面的例子中，在简单的HTML中加入了一些由${…}包围的特定FreeMarker的指令，这个文件就称为模板了。而user、latestProduct.url和latestProduct.name来自于数据模型，由Java程序提供，模板设计者就不用关心数据从哪来的。

FreeMarker模板中可以包括下面四种特定部分：
一.) 文本：直接输出
二.) FTL标记(FreeMarker模板语言标记)：类似于HTML标记，名字前加#(有些以@开始，用户自定义标记)予以区分，不会输出。
字符串－ 使用单引号或双引号限定；如果包含特殊字符需要转义符：${"It's \"quoted\" andthis is a backslash: \\"}
有一类特殊的字符串:${r"C:\foo\bar"}，输出结构为：C:\foo\bar，在引号前面加r被认为是纯文本。
数字－直接输入，不需要引号。${08}, ${+8}, ${8.00} and ${8} 都是相同的
布尔值－true和false，不使用引号
Sequences(序列)－由逗号分隔的变量列表，由方括号限定，类似java中的一维数组：

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>

输出结果：
winter
spring
summer
autumn

例二：[2 + 2, [1, 2, 3, 4], "whatnot"]
例三：2..5，等同于[2, 3, 4, 5]；5..2，等同于[5,4,3,2]。注意方括号是不需要的。

Hashes(散列)－由逗号分隔的键-值列表，由大括号限定，键和值之间用冒号分隔：{"name":"green mouse", "price":150}，键和值都是表达式，但是键必须是字符串。

获取变量－${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头。下列表达式是等价的：
book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

获取Sequence(序列)片断－使用[startindex..endindex]，例如：seq中存储了"a", "b", "c", "d","e"，那么seq[1..2]包含了b和c两个值。

可以使用.variablename语法访问FreeMarker内置变量。

字符串操作
{"Hello ${user}!"} <==> ${"Hello " + user + "!"}
${"${user}${user}${user}${user}"} <==> ${user + user + user + user}

${…}只能在文本中使用，下面是错误的代码：
<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>  //此处的代码也是错误的，因为if指令需要的是boolean，实际的却是个字符串

子字符串的操作，假设user的值为"Big Joe"：
${user[0]}${user[4]}  <==>  BJ
${user[1..4]}  <==> ig J

Sequences(序列)操作

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}
</#list>

结果：
- Joe
- Fred
- Julia
- Kate

Hashes(散列)操作

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}  

结果：
- Joe is 30
- Fred is 25
- Julia is 18 

算术运算

<#-- x的值设定为5 -->
${x * x - 100}
${x / 2}
${12 % 10}

结果：
-75
2.5
2

注意： 操作符两边必须是数字；使用"+"时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串。

使用内建的指令int获得整数部分：

结果：
2
1
1
-1
-1

比较操作符－<#if expression>...</#if>
1.)使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等
2.)=和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误
3.)Freemarker是精确比较，所以"x"、"x  "和"X"是不相等的
4.)对数字和日期可以使用<、<=、>和>=，但不能用于字符串
5.)由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>，另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

逻辑操作符－&&(and)、||(or)、!(not)，只能用于布尔值，否则会产生错误
<#if x < 12 && color = "green">
  We have less than 12 things, and they are green.
</#if>
<#if !hot> <#-- here hot must be a boolean -->
  It's not hot.
</#if> 

内置函数－用法类似访问hash(散列)的子变量，只是使用"?"替代"."，例如：user?upper_case
下面列出常用的一些函数：
对于字符串
html－对字符串进行HTML编码
cap_first－使字符串第一个字母大写
lower_case－将字符串转换成小写
trim－去掉字符串前后的空白字符
对于Sequences(序列)
size－获得序列中元素的数目
对于数字
int－取得数字的整数部分（如-1.9?int的结果是-1）

例一：

<#-- test的值为Tom & Jerry -->
${test?html}
${test?upper_case?html}

结果：
Tom &amp; Jerry
TOM &amp; JERRY

例二：

<#-- seasons的值为"winter", "spring", "summer", "autumn" --> 
${seasons?size}
${seasons[1]?cap_first} <#-- left side can by any expression -->
${"horse"?cap_first}  

结果：
4
Spring
Horse 

方法的调用
${repeat("What", 3)}
${repeat(repeat("x", 2), 3) + repeat("What", 4)?upper_case}
结果：
WhatWhatWhat
xxxxxxWHATWHATWHATWHAT

操作符优先顺序
后缀            [subvarName] [subStringRange] . (methodParams)
一元            +expr、-expr、!
内建            ?
乘法            *、 / 、%
加法            +、-
关系            <、>、<=、>=（lt、lte、gt、gte）
相等            =、!=
逻辑            &&
逻辑            ||
数字范围      ..

三.) Interpolation：由${...}或#{...}两种类型，输出计算值，可以定义输出的格式
例一：

<#setting number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string}  <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent} 

结果：
$42.00
$42.00
42
$42.00
4,200%

例二：

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}  

结果：
2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

例三：

<#assign foo=true/>
${foo?string("yes", "no")}

结果：
yes

例四：

<#-- x is 2.582 and y is 4 -->
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  -->  

说明：mX－小数部分最小X位；MX－小数部分最大X位。

四.) 注释：<#--和-->

下面是一个常用的模板例子：

<p>We have these animals:
<table border=1>
  <tr><th>Name<th>Price
  <#list animals as being>
  <tr>
    <td>
      <#if being.size = "large"><b></#if>
      ${being.name}
      <#if being.size="large"></b></#if>
    <td>${being.price} Euros
  </#list>
 </table> 
<#include "/copyright_footer.html">

注意点：
1.) FreeMarker是区分大小写的；
2.) FTL标记不能位于另一个FTL标记内部，例如：<#if <#include 'foo'>='bar'>...</if>；
3.) ${…}只能在文本中使用；
4.) 多余的空白字符会在模板输出时去除；
5.) 如果使用的指令不存在，会产生一个错误消息。

参考：    chenyun'blog - FreeMarker设计指南
              FreeMarker  in sourceforge.net

下面是一个解决中文乱码问题很有用的一个过滤器：

public class SetCharacterEncodingFilter implements Filter {
    
    public void destroy() {}
  
    public void doFilter(ServletRequest request, ServletResponse response,FilterChain chain)
       throws IOException, ServletException {

    request.setCharacterEncoding("GB2312");
    chain.doFilter(request, response);
    }

    public void init(FilterConfig filterConfig) throws ServletException {}
}

发布Servlet过滤器－在web.xml在文件中加入<filter>元素和<filter-mapping>元素

下面的例子中Servlet过滤器会过滤所有的URL：

<filter> 
<filter-name>Set Character Encoding</filter-name> 
<filter-class>SetCharacterEncodingFilter</filter-class> 
</filter> 
<filter-mapping> 
<filter-name>Set Character Encoding</filter-name>
<url-pattern>/*</url-pattern> 
</filter-mapping>

串连Servlet过滤器
多个Servlet过滤器可以协同工作，Servlet容器将根据它们在web.xml中定义的先后顺序，依次调用它们的doFilter()方法。
工作流程如下：
 Code1; // 表示调用chain.doFilter()前面的代码
 chain.doFilter();  // 表示调用下一个过滤器的doFilter()方法
 Code2; // 表示调用chain.doFilter()后面的代码

自定义JSP标签库
此技术在JSP 1.1版本中才出现，用来重用某些复杂的逻辑运算和事务，或定义JSP王爷的输出内容和格式。制作一个完整的自定义标签程序，包含3个步骤：

1. 创建标签的处理类
此类必须扩展javax.servlet.jsp.TagSupport类或者javax.servlet.jsp.BodyTagSupport类。
以TagSupport类为例，先了解一下这个类的主要方法：
doStartTag()－JSP容器遇到自定义标签的起始标志时调用该方法；
doEndTag()－JSP容器遇到自定义标签的结束标志时调用该方法；
setValue(String k,Object o)－在标签处理类中设置key/value;
getValue(String k)－在标签处理类中根据key返回匹配的value;
removeValue(String k)－在标签处理类中删除key/value;
setPageContext(PageContext pc)－设置PageContext对象，该方法在调用doStartTag()和doStartTag()前调用；
setParent(Tag t)－设置嵌套当前标签的上层标签的处理类，该方法在调用doStartTag()和doStartTag()前调用；
getParent()－返回嵌套当前标签的上层标签的处理类。

首先调用setPageContext(PageContext pc)和setParent(Tag t)，设置TagSupport类的两个重要属性值。

如果遇到起始标志，调用doStartTag()，此方法返回一个整数值，它有两个可选值：Tag.SKIP_BODY(标签之间的内容被忽略)和Tag.EVAL_BODY_INCLUDE(标签之间的内容正常执行)。
例如：<prefix:mytag>test</prefix:mytag>，如果遇上Tag.SKIP_BODY，test字符串不会显示在页面上；如果遇上Tag.EVAL_BODY_INCLUDE，test字符串将会显示在页面上。

如果遇到结束标志，调用doEndTag()，此方法也返回一个整数值，它有两个可选值：Tag.SKIP_PAGE(表示立刻停止执行JSP页面，网页上未处理的静态内容和JSP程序均别忽略，任何已有的输出内容立刻返回到客户端；)和Tag.EVAL_PAGE(表示按正常流程继续执行JSP页面)。

如果自定义标签包含自定义的属性，例如：<prefix:mytag attribute1="value1">，那么处理类中应该将这个属性做为成员变量，并提供一组get和set方法：
private int attribute1;
public void setAttribute1(int value){
 this.attriubte1 = value;
}
public int getAttribute1(){
 return attribute1;
}

下面是一个用来验证用户登陆的标签处理类例子：

public class ValidateLoginTag extends TagSupport{
    private String name;
    private String password;
    private Log log = LogFactory.getLog(ValidateLoginTag.class);

    public int doEndTag() throws JspException{

       if(name.equals("pepsixp") && password.equals("888888")){
              return(EVAL_PAGE);
          }
        return (SKIP_PAGE);
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

2.创建TLD－Tag Library Descriptor(标签库描述文件)
TLD文件中元素可以分为三类：<tablib>、<tag>、<attribute>
<tablib>－设定标签库的相关信息，包含的子元素有tlibversion、jspversion、shortname、uri、info、tag。
<tag>－用来定义一个标签，包含的子元素有name、tagcalss、bodycontent、info、attribute。
bodycontent的说明：有三个可选值empty、JSP、tagdependent，empty表示标签中没有body，JSP表示body中可以加入JSP程序代码，tagdependent表示body的内容有标签进行处理。
<attribute>－用来定义标签的属性，包含的子元素有name、required、rtexprvalue。
rtexprvalue的说明：表示是否可以使用<%=...%>类型的表达式，
例如：<prefix:mytaglib attribute1="<%=name%>">
下面是一个简单的TLD文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.1//EN" "http://java.sun.com/j2ee/dtds/web-jsptaglibrary_1_1.dtd">

<taglib>
    <tlibversion>1.2</tlibversion>
    <jspversion>1.1</jspversion>
    <shortname>MY Tag Library</shortname>
    <uri>http://www.blogjava.net/pepsixp/</uri>
    <info></info>
    <tag>
        <name>ifLogin</name>
        <tagclass>com.akazam.struts.taglib.ValidateLoginTag</tagclass>
        <bodycontent>empty</bodycontent>
        <info></info>
        <attribute>
            <name>name</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
        <attribute>
            <name>password</name>
            <required>true</required>
            <rtexprvalue>true</rtexprvalue>
        </attribute>
    </tag>
</taglib>

实际中的使用：
<%@ taglib uri="/tags/test" prefix="test" %>
<test:ifLogin name="pepsixp" password="888888"/>

3.在web应用中使用标签
先要在web.xml文件加入声明引用标签所在的标签：

<taglib>
        <taglib-uri>/tags/test</taglib-uri>
        <taglib-location>/WEB-INF/test.tld</taglib-location>
</taglib>

参考：《Tomcat与JavaWeb开发技术详解》

安全域
这是Tomcat服务器用来保护Web应用资源的一种机制。一个用户可以拥有一个或多个角色，每个角色限定了可访问的Web资源，这样就将用户和Web资源对应起来了。在org.apache.catalina.Realm接口中声名了将用户名、口令和角色相管理的方法，Tomcat5提供了4个实现这一接口的类，分别为：MemoryRealm(XML文件读取)、JDBCRealm(JDBC驱动程序读取)、DataSourceRealm(JNDI数据源读取)、JNDIRealm(JNDI provider读取LDAP的目录服务器信息)。

Web资源的设置
需要在web.xml文件中加入<security-constraint>、<login-config>、<security-role>元素。
例如在Tomcat的admin应用中的配置：

<security-constraint>
    <display-name>Tomcat Server Configuration Security Constraint</display-name>
    <web-resource-collection>
    <web-resource>Protected Area</web-resource>
        <url-pattern>*.htm</url-pattern>
        <url-pattern>*.jsp</url-pattern>
        <url-pattern>*.do</url-pattern>
    </web-resource-collection>
    <auth-constraint>
        <role-name>admin</role-name>
    </auth-constraint>
</security-constraint>

上面的代码表明：只有admin角色才能访问admin应用中的*.jsp、*.do和*.html资源。
另一个例子是jsp-examples应用：

<sercurity-constraint>
    <display-name>Tomcat Server Configuration Security Constraint</display-name>
    <web-resource-collection>
        <web-resource>Protected Area</web-resource>
        <url-pattern>/security/protected/*</url-pattern>
        <http-method>DELETE</http-method>
     <http-method>GET</http-method>
     <http-method>POST</http-method>
     <http-method>PUT</http-method>
    </web-resource-collection>
    <auth-constraint>
        <role-name>tomcat</role-name>
     <role-name>role1</role-name>
     </auth-constraint>
</security-constraint>

上面的代码表明：只要tomcat和role1角色才可以以DELETE、GET、POST和GET方式访问jsp-exzmples应用URL为/security/protected/下的资源。
在web.xml中加入<login-config>元素－系统会以对话框的方式进行登陆

<login-config>
    <auth-method>FORM</auth-method>
 <realm-name>Tomcat Configuration Form-Baseed Authenticaton Area</realm-name>
 <from-login-config>
        <from-login-page>/login/login.jsp</from-login-page>
     <from-error-page>/error.jsp</from-error-page>
 <from-login-config>
</login-config>

<auth-method>有三个可选项：BASIC、DIGEST、FORM。
BASIC－基本验证：访问受保护资源时，会弹出一对话框。要求输入用户名和密码，如果连续3次失败后，会显示一个错误页面。这个方法的缺点是用户名和密码的数据传输采用的是Base64编码(可读文本)，是非常不安全的。
DIGEST－摘要验证：数据采用MD5对用户名和密码进行加密，然后再传输，显然这种方法很安全。
FORM－表单验证：可以使用自定义的登陆页面，但用户名对应的文本框名称必须是j_username,密码为j_password，且表单action值为j_security_check。
在web.xml中加入<security-role>元素－指明这个Web应用应用的所有角色的名字

<security-role>
    <description>The role that is required to lon in to the Administration Application.</description>
 <role-name>admin</role-name>
 <role-name>friend</role-name>
</security-role>

你可以调用HttpRequeset接口的getRemoteUser()方法返回当前用户的名字：<%=request.getRemoteUser()%>

内存域－由org.apache.catalina.realm.MemoryRelam类实现
小猫启动时，自动读取<%CATALINA_HOME%>/conf/tomcat-users.xml文件，要在Web应用中使用，可以在对应的<Context>元素内加入如下内容：<Realm className="org.apache.catalina.realm.MemoryRelam"/>

JDBC域－通过JDBC驱动从数据库中直接读取验证信息，通过验证后，信息会存储在session中。
在mysql中新建两张表：

create table users{user_name varchar(15) not null primary key,user_pass varchar(15) not null };
create table usr_roles{usr_name varchar(15) not null,role_name varchar(15) not null,
  primary key(user_name,role_name)};

然后在server.xml中加入：

<Realm className="org.apache.catalina.realm.JDBCRealm" driverName="com.mysql.jdbc.Driver" 
             debug="0" connectionURL="jdbc:mysql://localhost/tomcatusers" connectionName="roor" 
             connectonPassword="" userTable="users" userNameCol="user_name" 
             userCredCol="user_pass" userRoleTable="user_roles" roleNameCol="role_name">

DataSource域－和JDBC域很类似，只不过访问数据库的方式不同，这个是使用JNDI DataSource来访问数据库的。
先在web.xml中加入安全约束，在和JDBC域一样新建两张表，然后在server.xml文件的<GlobalNamingResources>元素下添加如下内容：

<Resource name="jdbc/tomcatusers" auth="Container" type="javx.sql.DataSource"/>
<ResourceParams name="jdbc/tomcatusers">
    <parameter>
     <name>factory</name>
     <value>org.apache.commons.dbcp.BasicDataSourceFactory</value>
 </parameter>
 <parameter>
     <name>maxActiove</name>
     <value>100</value>
 </parameter>
 <parameter>
     <name>maxIdle</name>
     <value>30</value>
 </parameter>
 <parameter>
     <name>maxWait</name>
     <value>10000</value>
 </parameter>
 <parameter>
     <name>username</name>
     <value>root</value>
 </parameter>
 <parameter>
     <name>password</name>
     <value></value>
 </parameter>
 <parameter>
     <name>driverClassName</name>
     <value>com.mysql.jdbc.Driver</value>
 </parameter>
 <parameter>
     <name>url</name>
     <value>jdbc:mysql://localhost/tomcatusers?autoReconnect=true</value>
  </parameter>
</ResourceParams>

注意：Tomcat的JNDI资源必须配置在<GlobalNamingResources>元素下，服务器才能找到，否则会出现NameNotFoundException；低于Tomcat5.0.12的版本，即使正确配置了DataSourceRealm，也会出现找不到JNDI DataSource的异常，这个小猫的一个bug；在web.xml中是不需要配置<resource-ref>元素的，因为Web应用并不会访问这个DataSource。
当然server.xml还需要添加和JDBC域几乎相同的代码：

<Realm className="org.apache.catalina.realm.DataSourceRealm" 
             driverName="com.mysql.jdbc.Driver" debug="0" 
             connectionURL="jdbc:mysql://localhost/tomcatusers" connectionName="roor" 
             connectonPassword="" userTable="users" userNameCol="user_name" 
             userCredCol="user_pass" userRoleTable="user_roles" roleNameCol="role_name">

Tomcat阀
由org.apache.Catalina.Value接口定义，能够对Catalina容器接收的HTTP Request进行预处理，是小猫特有的功能，可以加入到3种容器中(Engine、Host、Context)。

客户访问日志阀(Access Log Value)－ 能够将可以的Request信息写入到日志中。可以记录页面访问的次数、用户Session活动和用户验证信息等。
例如：<Value className="org.apache.catalina.AccessLogValue" directory="logs" prifix="localhost_access_log" suffix=".txt" pattern="%h%l%u%t%s%r%s%b" resolveHost="true">
上面的pattern值可以用common，一个默认的值。
pattern属性规定日志的格式和内容：%a－远程IP地址；%A－本地IP地址；%b－发送的字节数，不包括HTTP Header；%h－远程主机名；%H－客户请求所用的协议；%l－"-";%m－请求的方法；%p－接受请求的本地服务器断开；%q－查询字符串；%r－用户请求的第一行内容；%s－响应HTTP Request的状态码；%S－用户Session ID；%t－时间；%u－验证的用户名；%U－请求URL路径；%v－本地服务器名。

远程地址过滤器(Remote Address Filter)－根据IP地址决定是否接受客户的请求。
例如：<Value className="org.apache.catalina.RemoteAddrValue" allow="127.0.0.1" deny="127.111.*"/>

远程主机过滤器(Remot Host Filter)－根据主机名决定是否接受请求。
<Value className="org.apache.catalina.RemoteHostValue" allow="localhost" deny="monster*"/>

客户请求记录器(Request Dumper)－把客户请求的详细信息记录在日志文件中，这里的日志文件是指<Logger>元素。
假定在server.xml中localhost的<Host>元素下已经配置了<Logger>元素：

<Logger className="org.apache.catalina.logger.FileLogger" directory="logs" prefix="localhos_log." 
              suffix=".txt" timestamp="true"/>

然后再添加<Value>元素：

<Value className="org.apache.catalina.RequestDumperValue"/>

参考：《Tomcat与JavaWeb开发技术详解》