You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@chemistry.apache.org by Maurizio Pillitu <m....@sourcesense.com> on 2010/07/26 19:59:04 UTC
OpenCMIS Server Archetype
Hi everyone,
I was following the "How to create a CMIS server using OpenCMIS"[1]
documentation page, but I got stuck on several issues, so I decided to build
and contribute a Maven Archetype; I've filed an issue[2] on Jira.
I think it would be a good idea to contribute it to the OpenCMIS project.
Looking forward to your feedback.
Regards,
Maurizio
[1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html
[2] - https://issues.apache.org/jira/browse/CMIS-243
--
Maurizio Pillitu - 0031 (0)615655668
Opensource Software Engineer
Scrum Certified Master - http://www.scrumalliance.org
Sourcesense - making sense of Open Source: http://www.sourcesense.com
Re: OpenCMIS Server Archetype
Posted by Maurizio Pillitu <m....@sourcesense.com>.
Hi Jens,
@5 you're right, it is a jar dependency, my bad.
@7 you're right, I removed the src/main/webapp/WEB-INF/web.xml so that the
opencmis-server-bindings is inherited
Changes have been committed to
http://github.com/sourcesense/cmis-server-archetype
Thanks,
Maurizio
On Tue, Jul 27, 2010 at 1:57 PM, Jens Hübel <jh...@opentext.com> wrote:
> Thanks Maurizio this is very valuable feedback. It seems that not all
> changes after the merge with the Chemistry code base have made it to the
> documentation. I have updated the page.
>
> Some comments:
>
> @1) Are sure that you have picked the correct archetype? The simple-webapp
> neither uses Spring nor Struts. I have used number 18 (there was a
> misleading sentence on the documentation page that I have removed now).
>
> @2) is related to 1), works for me
>
> @3) true, I have fixed this
>
> @4) true, I have fixed this
>
> @5) I don't get this one. chemistry-opencmis-server-support is a jar.
>
> @6) Until we have a release I assume that opencmis is built and installed
> in your local repository. I have added a hint on the page.
>
> @7) The mechanism is different. You don't have to uncompress and extract
> anything manually. The overlay mechanism uses the web.xml from the
> server-bindings project (and it requires some more files from there like the
> wsdls). But in the documentation the hint is missing that you have to delete
> the generated src/webapp directory so that this works. I have added this
> hint.
>
> @8) That's up to the user where he wants to deploy. I have added a hint to
> the jetty target in maven.
>
> Perhaps we also should add the complete code to subversion as an easier
> starting point. I will discuss this in the Chemistry community.
>
> Thanks again.
>
> Jens
>
>
>
> -----Original Message-----
> From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
> Sent: Dienstag, 27. Juli 2010 10:40
> To: chemistry-dev@incubator.apache.org
> Subject: Re: OpenCMIS Server Archetype
>
> Hi Jens,
> sure, I can provide you with more details, but in general the archetype
> aims
> to simplify the maven approach, therefore the first part of the
> documentation.
>
> 1.The documentation guides the user through the creation of a webapp using
> a
> specific archetype; this archetype contains spring, struts and many other
> dependencies that are not necessary for building an OpenCMIS server and
> makes the pom.xml heavier.
>
> 2. The final pom is posted as code, but copy/pasting it on top of the
> previously created archetype breaks, since none of the spring/struts
> dependencies are there anymore
>
> 3. the POM overlay on org.opencmis.opencmis-server-impl is wrong, should be
> org.apache.chemistry.opencmis.chemistry-server-bindings; you don't need to
> specify an overlay, maven does it automatically if the POM packaging=WAR
> and
> there's only one WAR dependency
>
> 4. All org.apache.chemistry.opencmis.opencmis-* dependencies should
> be org.apache.chemistry.opencmis.chemistry-opencmis-* ; the build cannot
> find the dependencies
>
> 5. org.apache.chemistry.opencmis.chemistry-opencmis-server-support is of
> type POM; if not specified the build fails
>
> 6. Missing Maven repository to fetch the last SNAPSHOT versions:
> http://repository.apache.org/snapshots
>
> 7. In order to get the WAR to work, you need to manually uncompress the
> opencmis-server-bindings-XXXX.war and copy the WEB-INF/web.xml in
> src/main/webapp/WEB-INF
>
> 8. Instead of asking the user to deploy the WAR, why not using the Maven
> Jetty Plugin?
>
> This is the pom.xml[1] that is generated by the archetype, containing all
> the fixes I just mentioned you.
>
> I think that the new documentation of the Maven approach should just
> mention:
>
> > mvn archetype:generate -DarchetypeArtifactId=my-cmis-server-archetype
> -DarchetypeGroupId=org.apache.chemistry.opencmis.server
> -DarchetypeVersion=0.1.0-incubating-SNAPSHOT
>
> > cd ${artifactId}
>
> > mvn jetty:run
>
> so that the user can better focus on the server implementation details,
> rather then the development environment.
>
> WDYT?
>
> Maurizio
>
> [1] -
>
> http://github.com/sourcesense/cmis-server-archetype/blob/c749484ded318185735065ddc7f5a8da48a3ce53/src/main/resources/archetype-resources/pom.xml
>
> On Tue, Jul 27, 2010 at 10:15 AM, Jens Hübel <jh...@opentext.com> wrote:
>
> > Hi Maurizio,
> >
> > thanks for providing feedback. Could you perhaps provide some more
> details
> > in what kind of issues you ran?
> > I would be happy to update the documentation in case that there are
> errors.
> >
> > Thanks Jens
> >
> >
> > -----Original Message-----
> > From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
> > Sent: Montag, 26. Juli 2010 19:59
> > To: chemistry-dev@incubator.apache.org
> > Subject: OpenCMIS Server Archetype
> >
> > Hi everyone,
> > I was following the "How to create a CMIS server using OpenCMIS"[1]
> > documentation page, but I got stuck on several issues, so I decided to
> > build
> > and contribute a Maven Archetype; I've filed an issue[2] on Jira.
> >
> > I think it would be a good idea to contribute it to the OpenCMIS project.
> >
> > Looking forward to your feedback.
> > Regards,
> > Maurizio
> >
> > [1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html
> > [2] - https://issues.apache.org/jira/browse/CMIS-243
> >
> > --
> > Maurizio Pillitu - 0031 (0)615655668
> > Opensource Software Engineer
> > Scrum Certified Master - http://www.scrumalliance.org
> > Sourcesense - making sense of Open Source: http://www.sourcesense.com
> >
>
>
>
> --
>
> Met vriendelijke groet,
> --
> Maurizio Pillitu - 0031 (0)615655668
> Opensource Software Engineer
> Scrum Certified Master - http://www.scrumalliance.org
> Sourcesense - making sense of Open Source: http://www.sourcesense.com
>
--
Met vriendelijke groet,
--
Maurizio Pillitu - 0031 (0)615655668
Opensource Software Engineer
Scrum Certified Master - http://www.scrumalliance.org
Sourcesense - making sense of Open Source: http://www.sourcesense.com
RE: OpenCMIS Server Archetype
Posted by Jens Hübel <jh...@opentext.com>.
Thanks Maurizio this is very valuable feedback. It seems that not all changes after the merge with the Chemistry code base have made it to the documentation. I have updated the page.
Some comments:
@1) Are sure that you have picked the correct archetype? The simple-webapp neither uses Spring nor Struts. I have used number 18 (there was a misleading sentence on the documentation page that I have removed now).
@2) is related to 1), works for me
@3) true, I have fixed this
@4) true, I have fixed this
@5) I don't get this one. chemistry-opencmis-server-support is a jar.
@6) Until we have a release I assume that opencmis is built and installed in your local repository. I have added a hint on the page.
@7) The mechanism is different. You don't have to uncompress and extract anything manually. The overlay mechanism uses the web.xml from the server-bindings project (and it requires some more files from there like the wsdls). But in the documentation the hint is missing that you have to delete the generated src/webapp directory so that this works. I have added this hint.
@8) That's up to the user where he wants to deploy. I have added a hint to the jetty target in maven.
Perhaps we also should add the complete code to subversion as an easier starting point. I will discuss this in the Chemistry community.
Thanks again.
Jens
-----Original Message-----
From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
Sent: Dienstag, 27. Juli 2010 10:40
To: chemistry-dev@incubator.apache.org
Subject: Re: OpenCMIS Server Archetype
Hi Jens,
sure, I can provide you with more details, but in general the archetype aims
to simplify the maven approach, therefore the first part of the
documentation.
1.The documentation guides the user through the creation of a webapp using a
specific archetype; this archetype contains spring, struts and many other
dependencies that are not necessary for building an OpenCMIS server and
makes the pom.xml heavier.
2. The final pom is posted as code, but copy/pasting it on top of the
previously created archetype breaks, since none of the spring/struts
dependencies are there anymore
3. the POM overlay on org.opencmis.opencmis-server-impl is wrong, should be
org.apache.chemistry.opencmis.chemistry-server-bindings; you don't need to
specify an overlay, maven does it automatically if the POM packaging=WAR and
there's only one WAR dependency
4. All org.apache.chemistry.opencmis.opencmis-* dependencies should
be org.apache.chemistry.opencmis.chemistry-opencmis-* ; the build cannot
find the dependencies
5. org.apache.chemistry.opencmis.chemistry-opencmis-server-support is of
type POM; if not specified the build fails
6. Missing Maven repository to fetch the last SNAPSHOT versions:
http://repository.apache.org/snapshots
7. In order to get the WAR to work, you need to manually uncompress the
opencmis-server-bindings-XXXX.war and copy the WEB-INF/web.xml in
src/main/webapp/WEB-INF
8. Instead of asking the user to deploy the WAR, why not using the Maven
Jetty Plugin?
This is the pom.xml[1] that is generated by the archetype, containing all
the fixes I just mentioned you.
I think that the new documentation of the Maven approach should just
mention:
> mvn archetype:generate -DarchetypeArtifactId=my-cmis-server-archetype -DarchetypeGroupId=org.apache.chemistry.opencmis.server -DarchetypeVersion=0.1.0-incubating-SNAPSHOT
> cd ${artifactId}
> mvn jetty:run
so that the user can better focus on the server implementation details,
rather then the development environment.
WDYT?
Maurizio
[1] -
http://github.com/sourcesense/cmis-server-archetype/blob/c749484ded318185735065ddc7f5a8da48a3ce53/src/main/resources/archetype-resources/pom.xml
On Tue, Jul 27, 2010 at 10:15 AM, Jens Hübel <jh...@opentext.com> wrote:
> Hi Maurizio,
>
> thanks for providing feedback. Could you perhaps provide some more details
> in what kind of issues you ran?
> I would be happy to update the documentation in case that there are errors.
>
> Thanks Jens
>
>
> -----Original Message-----
> From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
> Sent: Montag, 26. Juli 2010 19:59
> To: chemistry-dev@incubator.apache.org
> Subject: OpenCMIS Server Archetype
>
> Hi everyone,
> I was following the "How to create a CMIS server using OpenCMIS"[1]
> documentation page, but I got stuck on several issues, so I decided to
> build
> and contribute a Maven Archetype; I've filed an issue[2] on Jira.
>
> I think it would be a good idea to contribute it to the OpenCMIS project.
>
> Looking forward to your feedback.
> Regards,
> Maurizio
>
> [1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html
> [2] - https://issues.apache.org/jira/browse/CMIS-243
>
> --
> Maurizio Pillitu - 0031 (0)615655668
> Opensource Software Engineer
> Scrum Certified Master - http://www.scrumalliance.org
> Sourcesense - making sense of Open Source: http://www.sourcesense.com
>
--
Met vriendelijke groet,
--
Maurizio Pillitu - 0031 (0)615655668
Opensource Software Engineer
Scrum Certified Master - http://www.scrumalliance.org
Sourcesense - making sense of Open Source: http://www.sourcesense.com
Re: OpenCMIS Server Archetype
Posted by Maurizio Pillitu <m....@sourcesense.com>.
Hi Jens,
sure, I can provide you with more details, but in general the archetype aims
to simplify the maven approach, therefore the first part of the
documentation.
1.The documentation guides the user through the creation of a webapp using a
specific archetype; this archetype contains spring, struts and many other
dependencies that are not necessary for building an OpenCMIS server and
makes the pom.xml heavier.
2. The final pom is posted as code, but copy/pasting it on top of the
previously created archetype breaks, since none of the spring/struts
dependencies are there anymore
3. the POM overlay on org.opencmis.opencmis-server-impl is wrong, should be
org.apache.chemistry.opencmis.chemistry-server-bindings; you don't need to
specify an overlay, maven does it automatically if the POM packaging=WAR and
there's only one WAR dependency
4. All org.apache.chemistry.opencmis.opencmis-* dependencies should
be org.apache.chemistry.opencmis.chemistry-opencmis-* ; the build cannot
find the dependencies
5. org.apache.chemistry.opencmis.chemistry-opencmis-server-support is of
type POM; if not specified the build fails
6. Missing Maven repository to fetch the last SNAPSHOT versions:
http://repository.apache.org/snapshots
7. In order to get the WAR to work, you need to manually uncompress the
opencmis-server-bindings-XXXX.war and copy the WEB-INF/web.xml in
src/main/webapp/WEB-INF
8. Instead of asking the user to deploy the WAR, why not using the Maven
Jetty Plugin?
This is the pom.xml[1] that is generated by the archetype, containing all
the fixes I just mentioned you.
I think that the new documentation of the Maven approach should just
mention:
> mvn archetype:generate -DarchetypeArtifactId=my-cmis-server-archetype -DarchetypeGroupId=org.apache.chemistry.opencmis.server -DarchetypeVersion=0.1.0-incubating-SNAPSHOT
> cd ${artifactId}
> mvn jetty:run
so that the user can better focus on the server implementation details,
rather then the development environment.
WDYT?
Maurizio
[1] -
http://github.com/sourcesense/cmis-server-archetype/blob/c749484ded318185735065ddc7f5a8da48a3ce53/src/main/resources/archetype-resources/pom.xml
On Tue, Jul 27, 2010 at 10:15 AM, Jens Hübel <jh...@opentext.com> wrote:
> Hi Maurizio,
>
> thanks for providing feedback. Could you perhaps provide some more details
> in what kind of issues you ran?
> I would be happy to update the documentation in case that there are errors.
>
> Thanks Jens
>
>
> -----Original Message-----
> From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
> Sent: Montag, 26. Juli 2010 19:59
> To: chemistry-dev@incubator.apache.org
> Subject: OpenCMIS Server Archetype
>
> Hi everyone,
> I was following the "How to create a CMIS server using OpenCMIS"[1]
> documentation page, but I got stuck on several issues, so I decided to
> build
> and contribute a Maven Archetype; I've filed an issue[2] on Jira.
>
> I think it would be a good idea to contribute it to the OpenCMIS project.
>
> Looking forward to your feedback.
> Regards,
> Maurizio
>
> [1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html
> [2] - https://issues.apache.org/jira/browse/CMIS-243
>
> --
> Maurizio Pillitu - 0031 (0)615655668
> Opensource Software Engineer
> Scrum Certified Master - http://www.scrumalliance.org
> Sourcesense - making sense of Open Source: http://www.sourcesense.com
>
--
Met vriendelijke groet,
--
Maurizio Pillitu - 0031 (0)615655668
Opensource Software Engineer
Scrum Certified Master - http://www.scrumalliance.org
Sourcesense - making sense of Open Source: http://www.sourcesense.com
RE: OpenCMIS Server Archetype
Posted by Jens Hübel <jh...@opentext.com>.
Hi Maurizio,
thanks for providing feedback. Could you perhaps provide some more details in what kind of issues you ran?
I would be happy to update the documentation in case that there are errors.
Thanks Jens
-----Original Message-----
From: Maurizio Pillitu [mailto:m.pillitu@sourcesense.com]
Sent: Montag, 26. Juli 2010 19:59
To: chemistry-dev@incubator.apache.org
Subject: OpenCMIS Server Archetype
Hi everyone,
I was following the "How to create a CMIS server using OpenCMIS"[1]
documentation page, but I got stuck on several issues, so I decided to build
and contribute a Maven Archetype; I've filed an issue[2] on Jira.
I think it would be a good idea to contribute it to the OpenCMIS project.
Looking forward to your feedback.
Regards,
Maurizio
[1] - http://incubator.apache.org/chemistry/how-to-build-a-server.html
[2] - https://issues.apache.org/jira/browse/CMIS-243
--
Maurizio Pillitu - 0031 (0)615655668
Opensource Software Engineer
Scrum Certified Master - http://www.scrumalliance.org
Sourcesense - making sense of Open Source: http://www.sourcesense.com