You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by dl...@apache.org on 2005/08/02 06:07:30 UTC
svn commit: r226937 - in /portals/jetspeed-2/trunk: ./ jetspeed-api/xdocs/
layout-portlets/xdocs/ maven-plugin/xdocs/ portal-webapp/xdocs/
portlet-api/xdocs/ taglibs/treecontrol/xdocs/ xdocs/
Author: dlestrat
Date: Mon Aug 1 21:07:23 2005
New Revision: 226937
URL: http://svn.apache.org/viewcvs?rev=226937&view=rev
Log:
Adding PDF documentation support.
Modified:
portals/jetspeed-2/trunk/jetspeed-api/xdocs/navigation.xml
portals/jetspeed-2/trunk/layout-portlets/xdocs/navigation.xml
portals/jetspeed-2/trunk/maven-plugin/xdocs/navigation.xml
portals/jetspeed-2/trunk/maven.xml
portals/jetspeed-2/trunk/portal-webapp/xdocs/navigation.xml
portals/jetspeed-2/trunk/portlet-api/xdocs/navigation.xml
portals/jetspeed-2/trunk/project.properties
portals/jetspeed-2/trunk/taglibs/treecontrol/xdocs/navigation.xml
portals/jetspeed-2/trunk/xdocs/navigation.xml
portals/jetspeed-2/trunk/xdocs/user-attributes.xml
Modified: portals/jetspeed-2/trunk/jetspeed-api/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/jetspeed-api/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/jetspeed-api/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/jetspeed-api/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2" href="../../index.html"/>
- </links>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/jetspeed-api.pdf" img="../../images/pdf.gif" />
+ </links>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/layout-portlets/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/layout-portlets/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/layout-portlets/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/layout-portlets/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2" href="../../index.html"/>
- </links>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/jetspeed-layouts.pdf" img="../../images/pdf.gif" />
+ </links>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/maven-plugin/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/maven-plugin/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/maven-plugin/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/maven-plugin/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2" href="../../index.html"/>
- </links>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/maven-jetspeed2-plugin.pdf" img="../../images/pdf.gif" />
+ </links>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/maven.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/maven.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/maven.xml (original)
+++ portals/jetspeed-2/trunk/maven.xml Mon Aug 1 21:07:23 2005
@@ -146,7 +146,8 @@
<attainGoal name="multiproject:create-nav"/>
<attainGoal name="multiproject:create-overview-page"/>
- <attainGoal name="site" />
+ <attainGoal name="site" />
+ <attainGoal name="pdf" />
</goal>
Modified: portals/jetspeed-2/trunk/portal-webapp/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/portal-webapp/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/portal-webapp/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/portal-webapp/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,26 +1,28 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2" href="../../index.html"/>
- </links>
- <menu name="Misc.">
- <item name="Tasks" href="tasks.html"/>
- </menu>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/jetspeed.pdf" img="../../images/pdf.gif" />
+ </links>
+ <menu name="Misc.">
+ <item name="Tasks" href="tasks.html" />
+ </menu>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/portlet-api/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/portlet-api/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/portlet-api/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/portlet-api/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,26 +1,28 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2 Home" href="../../../site/target/docs/index.html"/>
- </links>
- <menu name="Misc.">
- <item name="Tasks" href="tasks.html"/>
- </menu>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2 Home" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/portlet-api.pdf" img="../../images/pdf.gif" />
+ </links>
+ <menu name="Misc.">
+ <item name="Tasks" href="tasks.html" />
+ </menu>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/project.properties
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/project.properties?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/project.properties (original)
+++ portals/jetspeed-2/trunk/project.properties Mon Aug 1 21:07:23 2005
@@ -84,7 +84,9 @@
jar.includes=applications/gems/project.xml,portlet-api/project.xml,commons/project.xml,cps/project.xml,content-server/project.xml,jetspeed-api/project.xml,portal-webapp/project.xml,components/**/project.xml,taglibs/treecontrol/project.xml
jar.excludes=/project.xml,maven-plugin/**,layout-portlets/**,applications/project.xml,applications/demo/**,applications/jsf-demo/**,applications/localeselector/**,applications/palm/**,applications/pam/**,applications/perl/**,applications/php/**,applications/rss/**,applications/security/**,applications/struts-demo/**,,applications/jpetstore/**site/project.xml,design-docs/project.xml
-maven.multiproject.site.goals=site dashboard:report-single
+maven.multiproject.site.goals=site pdf dashboard:report-single
+# For site only, comment line above, uncomment line below.
+#maven.multiproject.site.goals=site dashboard:report-single
## Dashboard plugin
maven.dashboard.includes=${maven.multiproject.includes}
Modified: portals/jetspeed-2/trunk/taglibs/treecontrol/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/taglibs/treecontrol/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/taglibs/treecontrol/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/taglibs/treecontrol/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<project>
- <body>
- <links>
- <item name="Jetspeed 2" href="../../index.html"/>
- </links>
- </body>
+ <body>
+ <links>
+ <item name="Jetspeed 2" href="../../index.html" />
+ <!-- Cannot access ${pom.id}... Hard coding pdf name. -->
+ <item name="PDF Documentation" href="/jetspeed2-taglib-treecontrol.pdf" img="../../images/pdf.gif" />
+ </links>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/xdocs/navigation.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/xdocs/navigation.xml (original)
+++ portals/jetspeed-2/trunk/xdocs/navigation.xml Mon Aug 1 21:07:23 2005
@@ -1,65 +1,68 @@
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-Copyright 2004 The Apache Software Foundation
-
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
-
+ Copyright 2004 The Apache Software Foundation
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
http://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
-->
<!--
- WARNING: This file is generated. The source is xdocs-templates/navigation.xml
-
- Note: Changes to this file are not reflected on the generated site until the
- allSite goal is atained, i.e. maven allSite
- -->
+ WARNING: This file is generated. The source is xdocs-templates/navigation.xml
+
+ Note: Changes to this file are not reflected on the generated site until the
+ allSite goal is atained, i.e. maven allSite
+-->
<project>
- <body>
- <menu name="Essentials">
- <item name="Overview" href="index.html"/>
- <item name="Getting Started" href="getting-started.html"/>
- <item name="Database" href="database.html"/>
- <item name="Localization" href="l10n-guide.html"/>
- <item name="User Attributes" href="user-attributes.html"/>
- <item name="Sub Projects" href="projects-overview.html"/>
- <item name="Maven Plugin" href="j2-maven-plugin.html"/>
- <item name="Documentation" href="documentation.html"/>
- </menu>
- <menu name='Security'>
- <item name="Security Overview" href="multiproject/jetspeed-security/index.html"/>
- <item name="Architecture Overview" href="multiproject/jetspeed-security/arch.html"/>
- <item name="Authentication" href="multiproject/jetspeed-security/atn.html"/>
- <item name="JAAS Authorization" href="multiproject/jetspeed-security/atz.html"/>
- <item name="PSML Authorization" href="bronco.html"/>
- <item name="SPI: Providers and Handlers" href="spi.html"/>
- <item name="Security Services Configuration" href="multiproject/jetspeed-security/config.html"/>
- <item name="Single Sign on" href="sso.html"/>
- </menu>
- <menu name='Portal Design'>
- <item name="Portal Design Overview" href="portal-design.html"/>
- <item name="Layouts" href="layouts.html"/>
- <item name="Decorators" href="decorators.html"/>
- <item name="Jetspeed Power Tool" href="jpt.html"/>
- <item name="PSML" href="psml.html"/>
- <item name="Site" href="site.html"/>
- </menu>
- <menu name='Components'>
- <item name="Profiler" href="components/profiler.html"/>
- </menu>
- <menu name="Support">
- <item name="Mailing List" href="mail-lists.html"/>
- <item name="Bug Database" href="issue-tracking.html"/>
- <item name="Wiki" href="http://wiki.apache.org/portals/Jetspeed2"/>
- <item name="Quality Testing" href="quality-testing.html"/>
- <item name="Source Code Repository" href="source-code.html"/>
- </menu>
- </body>
+ <body>
+ <links>
+ <item name="PDF Documentation" href="/jetspeed2.pdf" img="images/pdf.gif" />
+ </links>
+ <menu name="Essentials">
+ <item name="Overview" href="index.html" />
+ <item name="Getting Started" href="getting-started.html" />
+ <item name="Database" href="database.html" />
+ <item name="Localization" href="l10n-guide.html" />
+ <item name="User Attributes" href="user-attributes.html" />
+ <item name="Sub Projects" href="projects-overview.html" />
+ <item name="Maven Plugin" href="j2-maven-plugin.html" />
+ <item name="Documentation" href="documentation.html" />
+ </menu>
+ <menu name='Security'>
+ <item name="Security Overview" href="multiproject/jetspeed-security/index.html" />
+ <item name="Architecture Overview" href="multiproject/jetspeed-security/arch.html" />
+ <item name="Authentication" href="multiproject/jetspeed-security/atn.html" />
+ <item name="JAAS Authorization" href="multiproject/jetspeed-security/atz.html" />
+ <item name="PSML Authorization" href="bronco.html" />
+ <item name="SPI: Providers and Handlers" href="spi.html" />
+ <item name="Security Services Configuration" href="multiproject/jetspeed-security/config.html" />
+ <item name="Single Sign on" href="sso.html" />
+ </menu>
+ <menu name='Portal Design'>
+ <item name="Portal Design Overview" href="portal-design.html" />
+ <item name="Layouts" href="layouts.html" />
+ <item name="Decorators" href="decorators.html" />
+ <item name="Jetspeed Power Tool" href="jpt.html" />
+ <item name="PSML" href="psml.html" />
+ <item name="Site" href="site.html" />
+ </menu>
+ <menu name='Components'>
+ <item name="Profiler" href="components/profiler.html" />
+ </menu>
+ <menu name="Support">
+ <item name="Mailing List" href="mail-lists.html" />
+ <item name="Bug Database" href="issue-tracking.html" />
+ <item name="Wiki" href="http://wiki.apache.org/portals/Jetspeed2" />
+ <item name="Quality Testing" href="quality-testing.html" />
+ <item name="Source Code Repository" href="source-code.html" />
+ </menu>
+ </body>
</project>
Modified: portals/jetspeed-2/trunk/xdocs/user-attributes.xml
URL: http://svn.apache.org/viewcvs/portals/jetspeed-2/trunk/xdocs/user-attributes.xml?rev=226937&r1=226936&r2=226937&view=diff
==============================================================================
--- portals/jetspeed-2/trunk/xdocs/user-attributes.xml (original)
+++ portals/jetspeed-2/trunk/xdocs/user-attributes.xml Mon Aug 1 21:07:23 2005
@@ -28,30 +28,30 @@
The Portlet Specification defines how Portlet Applications can use User Attributes.<br/>
The attributes must be defined in the portlet.xml like (see PLT.17.1):</p>
<source><![CDATA[
- <portlet-app version="1.0" xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd">
- <user-attribute>
- <description>User Given Name</description>
- <name>user.name.given</name>
- </user-attribute>
- <user-attribute>
- <description>User Last Name</description>
- <name>user.name.family</name>
- </user-attribute>
- <user-attribute>
- <description>User eMail</description>
- <name>user.home-info.online.email</name>
- </user-attribute>
- ...
- </portlet-app>]]></source>
+<portlet-app version="1.0" xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd">
+ <user-attribute>
+ <description>User Given Name</description>
+ <name>user.name.given</name>
+ </user-attribute>
+ <user-attribute>
+ <description>User Last Name</description>
+ <name>user.name.family</name>
+ </user-attribute>
+ <user-attribute>
+ <description>User eMail</description>
+ <name>user.home-info.online.email</name>
+ </user-attribute>
+ ...
+</portlet-app>]]></source>
<p>
Once attributes are defined like this, a portlet can access the current values for the logged on
user as an unmodifiable Map from the PortletRequest using the USER_INFO constant defined in the
PortletRequest interface (see PLT.17.2):</p>
<source>
- Map userInfo = (Map)request.getAttribute(PortletRequest.USER_INFO);
- String givenName = (userInfo!=null) ? (String)userInfo.get("user.name.given") : "";
- String lastName = (userInfo!=null) ? (String)userInfo.get("user.name.family") : "";
- String email = (userInfo!=null) ? (String)userInfo.get("user.home-info.online.email") : "";</source>
+Map userInfo = (Map)request.getAttribute(PortletRequest.USER_INFO);
+String givenName = (userInfo!=null) ? (String)userInfo.get("user.name.given") : "";
+String lastName = (userInfo!=null) ? (String)userInfo.get("user.name.family") : "";
+String email = (userInfo!=null) ? (String)userInfo.get("user.home-info.online.email") : "";</source>
<p>
What is not defined by the Portlet Specification is <em>how</em> the Portal
must map the defined User Attributes to concrete attributes of a user.</p>
@@ -61,7 +61,9 @@
Jetspeed-2 provides a very flexible way to define concrete User attributes and defining access to them.</p>
<p>
Concrete User attributes are stored using User Preferences for which Jetspeed-2 provides its own database
- back end for storage (which is customizable by the way like almost any component of Jetspeed-2)<br/>
+ back end for storage (which is customizable by the way like almost any component of Jetspeed-2). The user
+ attributes implementation leverages Jetspeed's
+ <a href="multiproject/jetspeed-prefs/index.html">java.util.prefs.Preferences</a> implementation.<br/>
The concrete User attributes are stored under a specific node in the User preferences and can contain
any named attribute at will.<br/>
These concrete User attributes can be mapped to the defined User Attributes in the portlet.xml in two ways:
@@ -99,26 +101,26 @@
the custom user attribute name and a "name-link" element defining the concrete attribute name to which it
is mapped:</p>
<source><![CDATA[
- <portlet-app version="1.0"
- xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
- xmlns:js="http://portals.apache.org/jetspeed">
- <js:user-attribute-ref>
- <js:name>user-name-given</js:name>
- <js:name-link>user.name.given</js:name-link>
- </js:user-attribute>
- <js:user-attribute-ref>
- <js:name>user-name-family</js:name>
- <js:name-link>user.name.family</js:name-link>
- </js:user-attribute>
- ...
- </portlet-app>]]></source>
+<portlet-app version="1.0"
+ xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_1_0.xsd"
+ xmlns:js="http://portals.apache.org/jetspeed">
+ <js:user-attribute-ref>
+ <js:name>user-name-given</js:name>
+ <js:name-link>user.name.given</js:name-link>
+ </js:user-attribute>
+ <js:user-attribute-ref>
+ <js:name>user-name-family</js:name>
+ <js:name-link>user.name.family</js:name-link>
+ </js:user-attribute>
+ ...
+</portlet-app>]]></source>
<p>
Using the above custom mapping as an example, the Portlet can now access the user attributes as follows:</p>
<source>
- Map userInfo = (Map)request.getAttribute(PortletRequest.USER_INFO);
- String givenName = (userInfo!=null) ? (String)userInfo.get("user-name-given") : "";
- String lastName = (userInfo!=null) ? (String)userInfo.get("user-name-family") : "";
- String email = (userInfo!=null) ? (String)userInfo.get("user.home-info.online.email") : "";</source>
+Map userInfo = (Map)request.getAttribute(PortletRequest.USER_INFO);
+String givenName = (userInfo!=null) ? (String)userInfo.get("user-name-given") : "";
+String lastName = (userInfo!=null) ? (String)userInfo.get("user-name-family") : "";
+String email = (userInfo!=null) ? (String)userInfo.get("user.home-info.online.email") : "";</source>
<p>
Note that the email attribute for which no custom mapping was defined still can be access using
exact name matching (provided the concrete attribute is defined for the logged on user).</p>
---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org