-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
115 lines (83 loc) · 4.33 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
jsfWeld1
Source archetype: weld-jsf-jee-minimal
What is it?
===========
This is your project! It's a barebones, deployable Maven 2 project to help you
get your foot in the door developing with Java EE 6. This project is setup to
allow you to create a compliant Java EE 6 application using JSF 2.0, CDI 1.0
and EJB 3.1 that can run on a certified application server (Full or Web
Profile). A persistence unit configuration is absent from this project, but
you can easily add one.
System requirements
===================
All you need to run this project is Java 5.0 (Java SDK 1.5) or greator and
Maven 2.0.10 or greater. This application is setup to be run on a Java EE 6
certified application server. It has been tested with GlassFish V3 and JBoss
AS 6.0.
If you want to deploy the application to a standalone Servlet Container, then
you will need to set one up. Alternatively, you can use a Maven command to run
the application in place on an embedded version of GlassFish.
Please note that Maven 2 project needs to use the JBoss Maven repository
because there are certain Java EE API JARs that are not yet publised to the
Maven Central Repository (see https://jira.jboss.org/jira/browse/WELD-222)
Deploying the application
=========================
You can deploy the application without moving any files around using the
embedded GlassFish application server.
To run the application using embedded GlassFish, execute this command:
mvn package embedded-glassfish:run
The application will be running at the following URL:
http://localhost:7070/jsfWeld1
To deploy the application to JBoss AS (standalone), first make sure that the
JBOSS_HOME environment variable points to a JBoss AS 6.0 installation.
Alternatively, you can set the location of JBoss AS using the following
profile defintion in the .m2/settings.xml file in your home directory:
<?xml version="1.0" encoding="UTF-8"?>
<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">
<profiles>
<profile>
<id>environment</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<jboss.home>/path/to/jboss-as-6.0.0.M1</jboss.home>
</properties>
</profile>
</profiles>
</settings>
You can now deploy to JBoss AS by executing the following command:
mvn package jboss:hard-deploy
Start JBoss AS. The application will be running at the following URL:
http://localhost:8080/jsfWeld1
If you want to deploy to GlassFish (standalone), you can upload the
target/jsfWeld1.war archive using the web-based administration console.
Importing the project into an IDE
=================================
If you created the project using the Maven 2 archetype wizard in your IDE
(Eclipse, NetBeans or IntelliJ IDEA), then there is nothing to do. You should
already have an IDE project.
If you created the project from the commandline using archetype:generate, then
you need to bring the project into your IDE. If you are using NetBeans 6.8 or
IntelliJ IDEA 9, then all you have to do is open the project as an existing
project. Both of these IDEs recognize Maven 2 projects natively.
To import into Eclipse, you first need to install the m2eclipse plugin. To get
started, add the m2eclipse update site (http://m2eclipse.sonatype.org/update/)
to Eclipse and install the m2eclipse plugin and required dependencies. Once
that is installed, you'll be ready to import the project into Eclipse.
Select File > Import... and select "Import... > Maven Projects" and select
your project directory. m2eclipse should take it from there.
Once in the IDE, you can execute the Maven commands through the IDE controls
to run the application on an embedded Servlet Container.
Resources
=========
Weld archetypes:
- Quickstart: http://seamframework.org/Documentation/WeldQuickstartForMavenUsers
- Issue tracker: https://jira.jboss.org/jira/browse/WELDX
- Source code: http://anonsvn.jboss.org/repos/weld/archetypes
- Forums: http://seamframework.org/Community/WeldUsers
JSR-299 overview: http://seamframework.org/Weld
JSF community site: http://www.javaserverfaces.org