编辑“Jetspeed/生成门户”

{{Jetspeed top}}

==先决条件==
*[[JDK]]
*[[Tomcat]]
*[[Maven]]

==生成Jetspeed门户==
首先我们创建一个新的名称为jetexpress的自定义门户，进入命令行选择下面命令：
<pre>mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-4:generate \
    -DarchetypeGroupId=org.apache.portals.jetspeed-2 \
    -DarchetypeArtifactId=jetspeed-archetype \
    -DarchetypeVersion=2.2.0 \
    -DartifactId=jetexpress \
    -Dpackage=org.apache.portals.tutorials \
    -DgroupId=org.apache.portals.tutorials \
    -Dversion=1.0-SNAPSHOT
</pre>

复制链接到命令行：
<pre>mvn org.apache.maven.plugins:maven-archetype-plugin:2.0-alpha-4:generate 
-DarchetypeGroupId=org.apache.portals.jetspeed-2 
-DarchetypeArtifactId=jetspeed-archetype 
-DarchetypeVersion=2.2.0 
-DartifactId=jetexpress 
-Dpackage=org.apache.portals.tutorials -DgroupId=org.apache.portals.tutorials -Dversion=1.0-SNAPSHOT</pre>

注意：如果修改了settings.xml 的localRepository请在此命令里加入“-DarchetypeRepository=仓库路径”，比如“-DarchetypeRepository=E:\Repository\maven\repository”

Maven会要求确认groupId，artifactId，version，package：
<pre>Confirm properties configuration:
groupId: org.apache.portals.tutorials
artifactId: jetexpress
version: 1.0-SNAPSHOT
package: org.apache.portals.tutorials
Y: : 
</pre>

这一步我们输入“Y”确认。

Maven会生成项目并提示“BUILD SUCCESSFUL”。这样一个名为jetexpress的项目就建成。

==项目结构==
生成的门户项目是一个Maven多模块项目，由一个简单的父项目，以及两个子模块：jetexpress-pa和jetexpress-portal。
<pre>jetexpress/
    |-- jetexpress-pa
    |   |-- jetspeed-mvn-pa-pom.xml
    |   |-- pom.xml
    |   `-- src
    |       `-- main
    |           |-- java
    |           |   `-- org
    |           |       `-- apache
    |           |           `-- portals
    |           |               `-- tutorials
    |           |                   `-- MyPortlet.java
    |           `-- webapp
    |               |-- WEB-INF
    |               |   |-- portlet.xml
    |               |   `-- web.xml
    |               |-- help.jsp
    |               |-- maximized.jsp
    |               `-- normal.jsp
    |-- jetexpress-portal
    |   |-- jetspeed-mvn-portal-pom.xml
    |   |-- pom.xml
    |   `-- src
    |       |-- main
    |       |   `-- webapp
    |       |       `-- WEB-INF
    |       |           `-- pages
    |       |               `-- default-page.psml
    |       `-- sql
    |           `-- min
    |               `-- j2-seed.xml
    |-- jetspeed-mvn-settings.xml
    `-- pom.xml
</pre>

jetexpress-portal子模块提供一个Jetspeed的门户网站。它包含了门户网站的所有配置，是做任何门户的全定制。

jetexpress-pa子模块提供了一个portlet应用程序，包含了在定制网站显示的portlet，生成了一个样本portlet，MyPortlet.java。

==构建和部署配置==
我们对前边生成的项目进行一些配置。配置应用服务器和数据库的位置,打开jetspeed-mvn-settings.xml找到org.apache.jetspeed.server.home节点，这里配置的是本地安装tomcat的路径。

 <org.apache.jetspeed.server.home> C:/Apache/ Tomcat 5.5/</org.apache.jetspeed.server.home>

找到org.apache.jetspeed.production.database.url节点，配置数据库地址。
<pre>
<org.apache.jetspeed.production.database.url>jdbc:derby: C:/Apache/ Tomcat 5.5/derby
/productiondb;create=true</org.apache.jetspeed.production.database.url>
</pre>

==配置Jetspeed的Maven插件==
找到Maven全局配置文件settings.xml ，Linux：~/.m2/settings.xml  Window：%USERPROFILE%\.m2\settings.xml，添加如下pluginGroup。
<pre><settings xmlns="http://maven.apache.org/POM/4.0.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
       http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <pluginGroups>
    <pluginGroup>org.apache.portals.jetspeed-2</pluginGroup>
  </pluginGroups>
  
  <!-- There might be more configuration here -->
       
</settings>
</pre>

==构建和部署自定义Jetspeed门户==
使用命令行进入项目根目录（jetexpress），运行如下命令：
 mvn jetspeed:mvn -Dtarget=all

以及建立自定义的门户项目，该命令还可以：
*	部署两个门户Portlet应用程序到Tomcat应用服务器；
*	创建Derby数据库中Jetspeed核心表；
*	生成包括角色，用户等的数据信息；

Maven会编译部署项目并提示“BUILD SUCCESSFUL”。

运行定制的Jetspeed门户,使用命令行进入Tomcat的bin目录。

如果使用Unix系统运行：
 ./catalina.sh run

如果使用Windows系统运行：
 catalina.bat run

第一次运行门户网站，需要一些时间，待服务器启动，如下：
 INFO: Server startup in 8948 ms

然后我们打开浏览器，并输入http://localhost:8080/jetexpress/portal

==参考来源==
*http://portals.apache.org/jetspeed-2

[[category:Jetspeed|S]]
{{Jetspeed}}