(Portal 开发读书笔记）WindowState

 WindowState 表示了Portlet 窗口的状态

JSR-168规范定义了三种窗口状态，（标准，最大化，最小化）

1. public class WindowState 
2. { 
3.   public static final WindowState NORMAL = new WindowState("normal"); 
4.  
5.   public static final WindowState MAXIMIZED = new WindowState("maximized"); 
6.  
7.   public static final WindowState MINIMIZED = new WindowState("minimized"); 
8.   private String _name; 
9.  
10.   public WindowState(String name) 
11.   { 
12.     if (name == null) { 
13.       throw new IllegalArgumentException("WindowState name can not be NULL"); 
14.     } 
15.     this._name = name.toLowerCase(Locale.ENGLISH); 
16.   } 
17.  
18.   public String toString() 
19.   { 
20.     return this._name; 
21.   } 
22.  
23.   public int hashCode() 
24.   { 
25.     return this._name.hashCode(); 
26.   } 
27.  
28.   public boolean equals(Object object) 
29.   { 
30.     if (object instanceof WindowState) { 
31.       return this._name.equals(((WindowState)object)._name); 
32.     } 
33.     return false; 
34.   } 
35. } 

最小化时候，render请求是被忽略的，而最大化时候，Portlet会显示一些额外信息。

-----

各种不同的Portal Server(比如Liferay)可以有自己的规范以外的特有的窗口状态

如何开发自定义窗口状态：

首先在portlet.xml的<supports>的<window-state>中声明这个Porlet所要支持的窗口状态，可以指定多个

1. <portlet> 
2. <portlet-name>bookCatalog</portlet-name> 
3. <portlet-class> 
4. chapter03.code.listing.base.BookCatalogPortlet</portlet-class> 
5. <supports> 
6. <mime-type>text/html</mime-type> 
7. <window-state>pop_up</window-state> 
8. ... 
9. </supports> 
10. ... 
11. </portlet> 

然后在portlet应用级别，也就是在portlet.xml中所有<portlet>元素的外面，声明自定义窗口状态,注意，这个window-state必须被Portlet应用所部属的Portal Server所支持

1. <portlet-app> 
2.  
3. <portlet> 
4. .. 
5. </portlet> 
6.  
7. <custom-window-state> 
8. <window-state>pop_up</window-state> 
9. </custom-window-state> 
10. ... 
11. </portlet-app>