Portletは、あらかじめ定義されたユーザ情報を参照することができます。ユーザ情報を参照するためには、参照したいユーザ情報のキーをportlet.xmlで宣言する必要があります。以下に例を示します。
<portlet-app>
…
<user-attribute>
<description>名前</description>
<name>com.fujitsu.portalworks.common_name</name>
</user-attribute>
<user-attribute>
<description>電話番号</description>
<name>user.business-info.telecom.telephone.number</name>
</user-attribute>
…
</portlet-app>このように宣言したキーを用いて、ユーザ情報をPortletからアクセスするには、次のように記述します。なお、ユーザ情報自体（ユーザの名前や電話番号など）は、Portal Container側が保持しているデータを参照することが想定されているため、ユーザ情報を定義する方法は、Portletの仕様では規定されていません。
Map stUserInfo = (Map) request.getAttribute(PortletRequest.USER_INFO);
String strUserName;
String strTelephone;
If (stUserInfo != null) {
strUserName =
(String) stUserInfo.get("com.fujitsu.portalworks.common_name");
strTelephone =
(String) stUserInfo.get("user.business-info.telecom.telephone.number");
}獲得できる情報には、以下があります。
内容 | キー名 |
|---|---|
名前 | com.fujitsu.portalworks.common_name |
ログオンID | user.name.nickName |
姓 | user.name.family |
名 | user.name.given |
電話番号 | user.business-info.telecom.telephone.number |
住所 | user.business-info.postal.street |
郵便番号 | user.business-info.postal.postalcode |
FAX | user.business-info.telecom.fax.number |
利用者選択言語 | com.fujitsu.portalworks.locale |
メールアドレス | user.business-info.online.email |
携帯電話 | user.business-info.telecom.mobile.number |
接続元IPアドレス | com.fujitsu.portalworks.remote_addr |
接続先ホスト名 | com.fujitsu.portalworks.remote_host |
肩書 | user.jobtitle |
また、Portletは各ユーザに応じた個々のプリファレンス（設定情報）をもつことができます。各プリファレンスのデフォルト値をportlet.xmlに定義します。以下に例を示します。portlet.xmlの記述方法については、“F.4 Portlet Applicationのパッケージ方法”を参照してください。
<portlet>
…
<portlet-preferences>
<preference>
<name>SleepTime</name>
<value>100</value>
</preference>
<preference>
<name>SearchEngine</name>
<value>http://www.google.co.jp/</value>
<value>http://www.yahoo.co.jp/</value>
<read-only>0</read-only>
</preference>
</portlet-preferences>
</portlet>プリファレンスの内容は、ActionRequest、またはRenderRequestのgetPreferencesメソッドを利用して、javax.portlet.PortletPreferencesインタフェースオブジェクトを取得し、参照することができます。また、processActionメソッドの中では、setValue、またはsetValuesメソッドを利用して値を変更することができます。ただし、read-onlyが、“0”で指定されているプリファレンスと、renderメソッドの中で参照されるすべてのプリファレンスは参照のみが可能です。Portletから参照するには、次のように記述します。
PortletPreferences stPrefs = request.getPreferences();
String[] strSearchEngine;
int nSleepTime;
strSearchEngine = stPrefs.getValues("SearchEngine", null);
nSleepTime = Integer.parseInt(stPrefs.getValue("SleepTime", null));