StringBeans用户说明书.docx
《StringBeans用户说明书.docx》由会员分享,可在线阅读,更多相关《StringBeans用户说明书.docx(24页珍藏版)》请在冰豆网上搜索。
StringBeans用户说明书
简介
参考手册Stringbeans的主要配置文件,portal.xml以及portlet.xml文件,相关类和配置Stringbeans门户使用的资源。
portal.xml和portlet.xml都位于$STRINGBEANS_HOME的/WEB- INF/目录。
portlet.xml中含量的标准,已在JSR168文档中所述。
这不会是冗余这里讨论。
然而,“内置“portlet类型与当前版本的Stringbeans来,将一节中描述的portlet。
对于特定的任务,从这些基本portlet类型创建的portlet,帮助文件是由点击“帮助“每个portlet模式。
在配置文件,portal.xml和/或portlet.xml中,修改将生效后,服务器重新启动。
假设
$ TOMCAT_HOME的指Tomcat安装的主目录。
$ STRINGBEANS_HOME指的是那里的stringbeans的安装路径。
配置
门户网站的默认配置
门户网站(Psite)是一个或多个门户网站的网页集合。
默认情况下,Stringbeans定义了4个Psites,如根,登录,模板和我的。
根Psite将被称为主页本文档后面。
阿Psite通常前缀/门户网站的网址。
例如:
http:
//localhost:
8080/stringbeans/portal指主页Psite,而http:
//localhost:
8080/stringbeans/portal/login指登录Psite。
注:
/门户网站将作为前缀假设在讨论Psites。
您可以创建许多Psites只要你喜欢,而且每个Psite可以有无限的Psite孩子(除了我的,例如:
/ MyCompany的/博客/ myblog一些限制,即Psite的名称不能开始与数字,不能是其中之一。
:
登录,我和模板。
Stringbeans版本每个Psites修改。
参阅管理更多细节Psites部分。
我是一个特殊的Psite凡登录的用户文件(s)是创建。
每个登录的用户将拥有自己的Psite(又名Psite的所有者)根据我的,这与他们的用户名命名的。
例如,管理员用户的Psite是:
/我/管理(供参考:
管理员Psite保留)。
此外,我Psite受到限制。
只有拥有者可以查看,编辑和管理他们的Psite。
因此,Psite和页面权限设置不需要为我的Psite。
没有Psite扩展(儿童)是允许的。
默认情况下,只有管理员用户拥有“权力“来修改其他预先定义Psites(你可以进一步配置其他Psites权限设置后)。
配置为默认模板视图将由我的第一次登录的用户将在下面讨论的看法。
模板Psite是另一个特殊Psite。
这Psite“主机”默认模板的所有其他Psites。
例如:
/模板/我/是为我的Psite默认模板是“托管“。
每个用户第一次登录谁在初期将得到一个视图“复制“从这里定义的模板。
因此,要定义一个默认的模板,例如,您公司的博客Psite,你作为管理员,应该把博客的模板下:
/模板/ MyCompany的/博客/。
否则,在模板中定义的模板将被提交给用户。
默认的模板,模板可配置(如果你是作为管理员登录)从这个路径:
/模板
注意:
路径是指到URI的路径。
如果您的网站是:
http:
//localhost:
8080/stringbeans,/模板路径是指:
http:
//localhost:
8080/stringbeans/portal/templates
配置用户的默认视图(我Psite),为您的网站的用户账户,即模板:
以admin登录用户(指内置帐户的用户信息部分。
转到/模板/通过输入我的:
http:
///门户/模板/我的
默认的模板将被显示。
默认情况下,管理员用户是这个模板,具有编辑和管理权限的所有者。
配置页面,你想。
您可以添加/删除有何页面/内容。
Psite和页面设置的链接位于无论是在页面的顶部或底部(或其他地方),就取决于您选择的主题。
所有的改变都存储和版本。
这允许你“回滚“到以前的版本。
指管理Psites的细节部分。
首页和登录Psite模板可以以相同的方式配置为上述配置我作为默认模板。
唯一的区别是URI的路径。
对于主页上,您可以点击“首页“入口链接或键入:
http:
///门户,而登录为:
http:
///门户/登录
管理Psites
每一个Psite,例如修改移动内容或添加/删除内容或网页,记录和版本。
这允许回滚到其Psite以前的版本的用户,如果他们想。
为此,Stringbeans提供Psites管理员Portlet。
目前,您只能从一个版本回滚或删除旧版本。
在未来,“差异“功能可能会引入以及自动释放空间为旧版本删除。
的SB-admin角色的用户权限“控制”(查看,删除,回滚)所有Psites版本,而普通用户只能访问他们的Psite。
所有Psites配置文件存储在$ STRINGBEANS_HOME/ WEB-INF文件/ psites目录。
每个Psite都有自己的子文件夹下,Psite是“父母“的。
例如,我的Psite将根据psites根文件夹,根据IT管理员Psite。
该Psite配置数据存储到相应的文件夹下psite_data Psite。
配置文件的名称是index.xml。
版本文件存储在版本的文件夹,配置文件为index.xml同一水平。
每个版本的文件被命名为根据其版本,如v_1.xml的第一个版本。
portlet的配置
端可以装在一个Stringbeans门户服务器在WEB-INF下的Stringbeans Web应用程序目录或其他Portlet的Web应用程序所在的文件portlet.xml中指定。
配置和portlet.xml文件内容是在JSR168标准文件规定,所以portlet.xml中配置的详细信息将不会被描述在这里。
具体的portlet的配置将讨论portlet的部分。
Stringbeans支持本地和外部的portlet(s)的部署。
本地Portlet是指在Stringbeans Web应用程序定义的portlet,而外部的portlet是指在portlet的Web应用程序在不同环境中部署(从Stringbeans外Web应用程序上下文)的portlet。
本地portlet部署
Stringbeans内部署Web环境的portlet:
添加您的Portlet定义(... portlet中>)到Portlet美元以下STRINGBEANS_HOME/ WEB-INF目录的配置文件,portlet.xml中。
复制您的portlet(类(ES)和/或JAR文件(s))和所有依赖于它的JAR文件的WEB-INF/classes或者WEB-INF/lib目录,即$ STRINGBEANS_HOME的/WEB- INF/lib目录。
注:
PortletAPI的类,即javax.portlet.xxxxxx已列入Stringbeans(portlet.jar)。
不要复制这些类的jar文件,也没有为STRINGBEANS_HOME/ WEB-INF文件/类和/或$STRINGBEANS_HOME的/WEB- INF/lib目录。
复制的jsp文件(如有)和所有的portlet的资源文件(图像等)到正确的位置,配置在portlet的定义,即至STRINGBEANS_HOME/ Portlet的目录。
外部Portlet的Web应用程序部署
下面的步骤是:
(手动)部署一个portlet Web应用程序Stringbeans。
配置您的portlet应用程序:
您的portlet的Web应用程序可以是一个战争背景下的文件或文件夹扩大战争的文件。
war文件或扩大战争的文件必须:
包含在WEB- INF目录portlet.xml文件。
portlet.xml中定义的Portlet必须遵守的JSR168规范。
注:
如果你正在部署一个Struts应用程序的Struts使用Stringbeans桥,一个特定的类和init参数用于定义Portlet定义。
例如一个基于Struts的应用程序的Portlet定义中可以找到基于Struts的应用程序部署部分。
定义com.nabhinc.portal.core.PortletServlet servlet和正确映射在portlet的部署描述符,web.xml中。
该网址的映射模式被称为servletURI在配置在下一步Portal配置。
在web.xml中条目是类似于以下内容:
∙
∙PortletServlet
∙
∙com.nabhinc.portal.core.PortletServlet
∙
∙1
∙
∙:
∙:
∙
∙PortletServlet
∙/portlet_servlet
∙
的并不是必需的,但建议,以确保portlet应用程序加载之前Stringbeans。
包括的SB- portal.jar,nabh- common.jar,和所有相关的jar文件(使用JAXB-api.jar,使用JAXB- impl.jar和jaxb1- impl.jar到WEB-INF/lib目录下。
包括portlet.tld(由$ STRINGBEANS_HOME/ WEB-INF文件)到一个目录的标签库在部署描述符web.xml中定义的URI映射元素。
在一个需要portlet.tld要在/ WEB-INF目录的web.xml找到的taglib项目的范例:
∙
∙
∙/WEB-INF/portlet.tld
∙
初步门户配置。
如果使用Tomcat的林分包捆绑Sringbeans被使用,这种配置一步已经为你做。
你可以跳过下一步。
portlet.jar的SB- container.jar和SB-股份common.jar文件必须在应用服务器的共享目录或“全球“类路径可以通过Stringbeans以及portlet应用程序(s)进行访问。
此外,这3个jar文件必须从$ STRINGBEANS_HOME的/WEB- INF/lib中/。
对于Tomcat,这3个jar文件被移动到$TOMCAT_HOME/共享/ lib/目录。
请注意,也没有portlet.jar的SB- container.jar中可以找到更多的应用程序的classpath过一次,例如:
在共享目录,并在Stringbeans'或portlet应用程序的WEB-INF/lib目录。
IncompatibleClassChangeError或ClassCastException将抛出
配置Stringbeans上下文共享或跨上下文。
想想部署Stringbeans方面只是另一个Web应用程序上下文。
请咨询您的共享或跨上下文配置应用服务器。
如果Tomcat使用,添加一个类似的条目在Tomcat的server.xml以下(在$ TOMCAT_HOME的/ conf目录位于:
∙∙docBase="stringbeans"crossContext="true"/>
此项目应在被用于Tomcat配置文件(默认的localhost appBase是webapps目录)的appBase虚拟主机,server.xml中。
您也可以包含在$ context.xml文件STRINGBEANS_HOME/ META-INF文件/只包含上述项目。
下面的步骤是需要为Portlet的Web应用程序的每一个将要部署完成。
如果你的应用服务器支持热部署,你现在可以重新启动服务器和配置在运行时执行以下步骤。
通过直接修改配置文件,它需要在服务器重新启动手动配置也将提供。
您的portlet部署Web应用程序。
这一步可能各有不同的应用服务器从一个。
请参考部署Web应用程序到应用程序服务器的文档。
这是假设你已经完成了第一步以上(并已包括所有必要的库)。
portlet应用程序可以是文件或战争爆发战争的文件(再次,进行磋商,以你的应用服务器)。
部署的portlet应用程序必须配置为一个共享或跨上下文。
它类似于步骤配置为共享的上下文Stringbeans上下文#2。
您还可以添加在您的portlet应用程序的每个META-INF/context.xml文件。
请注意,您必须重新启动Tomcat的server.xml中,如果是用于配置交叉背景。
在server.xml或context.xml中的其他项是类似于以下内容:
∙
添加到Stringbeans配置portlet应用程序上下文。
你可以在运行时使用门户配置UI或手动修改配置文件的门户,portal.xml:
使用Portal配置界面:
这一步必须仅允许Portlet的Web应用程序后,已成功部署。
登录以“admin“用户
单击Portlet的管理菜单标签。
按一下portlet应用程序左侧的导航窗格菜单。
点击新语境中的按钮。
一个窗体包含“上下文路径“和”的Servlet的URI“字段应显示。
在“上下文路径“栏,你的portlet应用程序上下文的名称输入(以斜线开始"/").此字段是必需的。
例如:
/ JPetStore的
“的Servlet的URI“字段是可选的。
你可以给这个领域的空白。
默认是:
/portlet_servlet。
点击“添加“按钮。
点击“继续“按钮。
注:
将显示一个警告,如果上下文名称是无效的。
门户网站配置文件手动配置,portal.xml位于STRINGBEANS_HOME美元以下/ WEB-INF目录。
新增您的portlet标记内父门户网站配置文件,应用程序的上下文路径项portal.xml。
该条目必须的contextPath属性,您可以指定您的portlet应用程序上下文的名称。
一个例子是在部分。
需要重新启动应用服务器配置完成后。
请注意,Stringbeans目前的执行情况并不能自动刷新portlet应用程序如果是在热部署更新。
但是,您可以“重新载入“portlet应用程序的portlet使用上述。
基于Struts的应用程序部署
Stringbeans包括Struts的桥梁,支持基于Struts的应用是作为JSR-168兼容的portlets部署。
为了成功地部署没有或很少变化Stringbeans PortalServer时,必须开发Struts应用程序使用:
Struts标签中呈现的所有资源(例如图像)的路径和操作链接。
适当的MVC acrhitecture,例如与使用的ActionForward重定向=“true“将发送一个Action处理后重定向到客户端。
Stringbeans开发Struts的大桥是在Apache Struts的桥顶和门户网站上发布1.2.4 Struts框架的基础。
以下是步骤准备和部署Struts应用程序,使用Struts桥Stringbeans:
按照外部Portlet的Web应用程序部署节说明配置Stringbeans以及Struts应用程序中的跨应用程序。
你应该参考你的Struts应用的Portlet Web应用程序的地方提到。
目录(上下文路径)在Struts应用程序将被安装在下面的步骤转介。
复制下面的库文件/ WEB-INF/lib中/美元STRINGBEANS_HOME/WEB-INF目录/lib/目录:
portals-bridges-common-x.x.jar,
portals-bridges-struts-x.x.jar,and
sb-strutsbridge.jar
定义一个Portlet定义,其中包括作为Portlet级和com.nabhinc.portlet.strutsbridge.impl.ServletContextProviderImplServletContextProvider init参数com.nabhinc.portlet.strutsbridge.StrutsPortlet。
一个典型的StrutsPortlet Portlet定义:
1.
xmlversion="1.0"encoding="UTF-8"?
>
2.3.xmlns="
4.version="1.0"xmlns:
xsi="http:
//www.w3.org/2001/XMLSchema-instance"
5.xsi:
schemaLocation=
6."
7.
8.
9.
10.....
11.....
12.....
13.
14.com.nabhinc.portlet.strutsbridge.StrutsPortlet
15.
16.
17.ServletContextProvider
18.
19.com.nabhinc.portlet.strutsbridge.impl.ServletContextProviderImpl
20.
21.
22.
23.ViewPage
24.....
25.
26.
27.HelpPage
28.....
29.
30.0
31.
32.text/html
33.VIEW
34.HELP
35.
36.
37.
....
38.....
39.
40.
41.
ViewPage,HelpPage和EditPage是Portlet的视图定义,分别帮助和编辑模式。
然而,有一个不断变化的模式,使用Struts大桥已知问题。
详见已知问题一节。
修改Struts应用程序的Web描述符web.xml:
替换操作的Servlet org.apache.struts.action.ActionServlet使用Struts大桥的PortletServlet类。
该行动的Servlet条目应如下所示:
1.
2.action
3.
4.org.apache.portals.bridges.struts.PortletServlet
5.
6.
7.:
8.:
9.
配置Struts应用程序
Struts的大桥包括四个罐子可提供增强的HTML的Struts的JSP(包括发光变体)版本的文件顶级域名:
struts-portlet.tld
struts-portlet-el.tld
struts-1.2.4-portlet-html.tld
struts-1.2.4-portlet-html-el.tld
这些增强的Struts的HTML JSP标签(HTML代码:
表格,HTML格式:
链接,HTML格式:
重写,HTML格式:
重写,和html:
img)应该用来解决资源的网址,例如:
图像,JavaScript和/或CSS样式表,它(大多数情况下)使用相对URL。
要使用这些顶级域名,您可以映射/定义在web.xml这些顶级域名或重新定义在JSP(s)相似的taglib的uri以下内容:
∙<%@tagliburi="http:
//portals.apache.org/bridges/struts/tags-portlet-html"prefix="html"%>
or
<%@tagliburi="http:
//portals.apache.org/bridges/struts/tags-portlet-html-el"prefix="html-el"%>
Forhtml:
linkandhtml:
rewrite,anadditionalattribute:
actionURL,renderURLorresourceURLcanbespecifiedtodeterminethetypeofURLgeneratedforthelinkorrewrite.DefaultisrenderURL="true",ifnoneoftheattributesisspecified.
Aminorchangesmightbeneededforrelativeimagepaththatwasnotdefinedusing