Mailing-List: contact jetspeed-dev-help@portals.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Jetspeed Developers List" <jetspeed-dev@portals.apache.org>
Received-SPF: pass (nike.apache.org: local policy)
From: "Dahl, Sandra" <SDahl@dvsAnalytics.com>
To: Jetspeed Developers List <jetspeed-dev@portals.apache.org>
Date: Mon, 8 Feb 2010 11:49:16 -0700
Subject: RE: login portlet extension
Thread-Topic: login portlet extension
Thread-Index: AcqlJTXCVDHiG48eQMS55lrqz18JCQDw33dw
Message-ID: <85471C1B26954D4D9622A450644A969001825814C2B8@m2.TDILAN.com>
References: <85471C1B26954D4D9622A450644A969001825814BAFE@m2.TDILAN.com>
	 <4a35d831002021553r50a2b4e9n416e259edc3a9eea@mail.gmail.com>
	 <85471C1B26954D4D9622A450644A969001825814BBDB@m2.TDILAN.com>
 <4a35d831002031503r629012e0re6f3651c0b9034e1@mail.gmail.com>
In-Reply-To: <4a35d831002031503r629012e0re6f3651c0b9034e1@mail.gmail.com>
Accept-Language: en-US
Content-Language: en-US
acceptlanguage: en-US
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0

Hi, David. Thank you for the example. I am trying the maven solution you ha=
ve below and get the error below when running org.apache.maven.plugins:mave=
n-war-plugin:2.0.2:war.

[INFO] Scanning for projects...
[INFO] --------------------------------------------------------------------=
----
[INFO] Building extended-j2admin Maven Webapp
[INFO]    task-segment: [org.apache.maven.plugins:maven-war-plugin:2.0.2:wa=
r]
[INFO] --------------------------------------------------------------------=
----
[INFO] [war:war {execution: default-cli}]
[INFO] Exploding webapp...
[INFO] Assembling webapp extended-j2admin in W:\eclipseWorkspace\extended-j=
2admin\target\extended-j2admin
[INFO] Copy webapp webResources to W:\eclipseWorkspace\extended-j2admin\tar=
get\extended-j2admin
[INFO] --------------------------------------------------------------------=
----
[ERROR] BUILD ERROR
[INFO] --------------------------------------------------------------------=
----
[INFO] Error unpacking file: W:\eclipseWorkspace\j2-admin\target\classesto:=
 W:\eclipseWorkspace\extended-j2admin\target\war\work\cla

Embedded error: The source must not be a directory.

ThankS! Sandi
-----Original Message-----
From: David Sean Taylor [mailto:d.taylor@onehippo.com]
Sent: Wednesday, February 03, 2010 4:04 PM
To: Jetspeed Developers List
Subject: Re: login portlet extension

On Wed, Feb 3, 2010 at 7:44 AM, Dahl, Sandra <SDahl@dvsanalytics.com> wrote=
:

> Thanks for the information, David. In general, what is the best practice
> for extending an existing Jetspeed portlet so future Jetspeed updates can=
 be
> easily implemented?
>
> I think there are two approaches you can take:

1. write your own administrative portlet application, and manage all code
yourself
2. overlay the j2-admin.war artifact from maven

The first solution doesn't work well for re-use, as much j2-admin's
functionality is hidden down in JSP files. Additionally, we do not
distribute j2-admin as a jar file to reuse java classes. With that in mind,
lets look at how you can approach the second solution.

Many people prefer Ant for this kind of processing. In fairness to Ant, let=
s
look at how you could do that. I didn't have an example with the j2-admin
war, but here is an similar example using the jetspeed layouts war.

<target name=3D'overlay-layouts'>
<mkdir dir=3D'${installer.target}/unpack/'/>
<unjar
src=3D"${installer.target}/portal/webapps/dash/WEB-INF/deploy/local/jetspee=
d-layouts.war"
   dest=3D"${installer.target}/unpack/jetspeed-layouts/"/>
<copy overwrite=3D'true'
todir=3D'${installer.target}/unpack/jetspeed-layouts/WEB-INF/'
      file=3D"./src/layouts/portlet.xml"/>
<jar
destfile=3D'${installer.target}/portal/webapps/dash/WEB-INF/deploy/local/je=
tspeed-layouts.war'
basedir=3D"${installer.target}/unpack/jetspeed-layouts/" update=3D'true'/>
</target>

In the target above, the Ant target overlays my customized portlet.xml on
top of the jetspeed-layouts war, and then create the new merged war file.
The downside to this approach, we don't take the jetspeed-layouts.war file
out of a Maven repository.

As a hybrid solution, if you prefer Ant but are required to use Maven, you
can embed ant commands into Maven at the generate-resources phase. There ar=
e
examples of this in the jetspeed-installer and enterprise sub-projects

Here is a pure Maven solution, which I would consider a best practice for
Maven builds. In this example I use the Maven War Plugin's overlay feature:

http://maven.apache.org/plugins/maven-war-plugin/overlays.html

Here is a complete pom.xml example:

<project xmlns=3D"http://maven.apache.org/POM/4.0.0" xmlns:xsi=3D"
http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation=3D"http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>org.apache.portals.jetspeed-2</groupId>
  <artifactId>extended-j2admin</artifactId>
  <packaging>war</packaging>
  <version>0.0.1-SNAPSHOT</version>
  <name>extended-j2admin Maven Webapp</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
    <dependency>
    <groupId>org.apache.portals.jetspeed-2</groupId>
    <artifactId>j2-admin</artifactId>
    <type>war</type>
    <version>2.2.1-SNAPSHOT</version>
    </dependency>
  </dependencies>
  <build>
    <finalName>extended-j2admin</finalName>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-war-plugin</artifactId>
        <configuration>
          <overlays>
            <overlay>
              <id>j2-admin</id>
      <groupId>org.apache.portals.jetspeed-2</groupId>
      <artifactId>j2-admin</artifactId>
            </overlay>
           <overlay>
              <!-- empty groupId/artifactId is detected as the current buil=
d
-->
            </overlay>
          </overlays>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

I have zipped up the entire project for you to play around with and put it
on my retired server here:

http://www.bluesunrise.com/jetspeed-2/2.2/extended-j2admin.zip

There are two files in the overlay project's webapp source:

1. the web.xml, to show an example of replacing an existing file, where I
simply changed the display-name and description as an example:

  <display-name>Sandra's Jetspeed-2 Portal Administration
Portlets</display-name>
  <description>Sandra's Administration Portlets for the Jetspeed-2
Enterprise Portal</description>

2. the index.jsp, to show an example of adding a new file

Confidentiality Notice:
The information contained in this communication, including attachments, is =
privileged and confidential.  It is intended only for the exclusive use of =
the addressee.  If the reader is not the intended recipient, or the employe=
e, or the agent responsible for delivering it to the intended recipient, yo=
u are hereby notified that any dissemination, distribution or copying of th=
is communication is strictly prohibited.  If you have received this communi=
cation in error, please notify us by return email or telephone immediately.=
  Thank you.

---------------------------------------------------------------------
To unsubscribe, e-mail: jetspeed-dev-unsubscribe@portals.apache.org
For additional commands, e-mail: jetspeed-dev-help@portals.apache.org