kontakty 

 Source archetype: weld-jsf-jee

 What is it?
 ===========

 This is your project! It's a sample, 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,
 EJB 3.1 and JPA 2.0) that can run on a certified application server (Complete
 or Web Profile). It includes a persistence unit and some sample persistence
 and transaction code to help you get your feet wet with database access in
 enterprise Java. 

 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
 =========================

 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/kontakty

 If you want to deploy to GlassFish (standalone), you first need to change
 the name of the DataSource used by the persistence unit! Open this file:

  src/main/resources/META-INF/persistence.xml

 Change the value of <jta-data-source> to the following:

  <jta-data-source>jdbc/__default</jta-data-source>

 This configuration uses the built-in default Derby DataSource in GlassFish.
 Optionally, you can use an alternative DataSource of your choice.
 
 Now, execute the command:

  mvn package
 
 You can now deploy the target/kontakty.war archive and launch the
 application the through GlassFish administration console.

 Alternatively, 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/kontakty

 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