ESAPI-Building - Revision history

Kevin W. Wall: Change references from using svn and Google Code to git and GitHub.

2016-02-09T05:30:21Z

Change references from using svn and Google Code to git and GitHub.

Daniel Serodio: Removing steps do download and install AntiSamy locally because it's already available on the Maven Central repository (and the dependency is correctly declared in the POM)

2011-11-24T13:43:16Z

Removing steps do download and install AntiSamy locally because it's already available on the Maven Central repository (and the dependency is correctly declared in the POM)

Jmanico at 10:47, 29 November 2009

2009-11-29T10:47:35Z

Kevin W. Wall: Changed directions so ESAPI code is checked out directly into 'ESAPI' directory with no extra 'trunk' directory.

2009-11-07T05:13:12Z

Changed directions so ESAPI code is checked out directly into 'ESAPI' directory with no extra 'trunk' directory.

Kevin W. Wall: Added 'cd trunk' between two mvn steps to prevent maven error about 'Cannot execute mojo: ...'.

2009-08-19T02:13:06Z

Added 'cd trunk' between two mvn steps to prevent maven error about 'Cannot execute mojo: ...'.

Jeff Williams at 15:12, 27 July 2009

2009-07-27T15:12:17Z

Jeff Williams at 03:17, 4 July 2009

2009-07-04T03:17:03Z

Jeff Williams at 03:16, 4 July 2009

2009-07-04T03:16:40Z

Pawan.Singh: /* Building */

2009-05-15T04:31:09Z

‎Building

Kevin.Fealey: /* Running Test Cases */

2009-04-16T18:46:39Z

‎Running Test Cases

@@ Line 1: / Line 1: @@
-ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven]. Ensure that you are using UTF-8 for all source code.
+ESAPI is easy to build yourself using [https://git-scm.com/ Git] and [http://maven.apache.org/ Maven]. Ensure that you are using UTF-8 for all source code.
-   $ svn checkout http://owasp-esapi-java.googlecode.com/svn/trunk ESAPI
+   $ git clone https://github.com/ESAPI/esapi-java-legacy.git    # This will clone the 'develop' branch.
-   $ cd ESAPI
+   $ cd esapi-java-legacy
    $ mvn -Dmaven.test.skip=true package  # Build ESAPI

@@ Line 3: / Line 3: @@
    $ svn checkout http://owasp-esapi-java.googlecode.com/svn/trunk ESAPI
    $ cd ESAPI
    $ mvn -Dmaven.test.skip=true package  # Build ESAPI

← Older revision		Revision as of 10:47, 29 November 2009
Line 1:		Line 1:
−	ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven].	+	ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven]. Ensure that you are using UTF-8 for all source code.

	$ svn checkout http://owasp-esapi-java.googlecode.com/svn/trunk ESAPI		$ svn checkout http://owasp-esapi-java.googlecode.com/svn/trunk ESAPI

@@ Line 1: / Line 1: @@
 ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven].
-   $ mkdir ESAPI
+   $ svn checkout http://owasp-esapi-java.googlecode.com/svn/trunk ESAPI
    $ cd ESAPI
    $ wget http://owaspantisamy.googlecode.com/files/antisamy-bin.1.3.jar
-   $ mvn install:install-file -DgroupId=OWASP -DartifactId=AntiSamy -Dversion=1.2 -Dpackaging=jar -Dfile=antisamy-bin.1.3.jar
+   $ mvn install:install-file -DgroupId=OWASP -DartifactId=AntiSamy -Dversion=1.3 -Dpackaging=jar -Dfile=antisamy-bin.1.3.jar
-   $ cd trunk
+   $ rm antisamy-bin.1.3.jar             # Cleanup after Maven copies to repository.
-   $ mvn -Dmaven.test.skip=true package
+   $ mvn -Dmaven.test.skip=true package  # Build ESAPI
 Maven will generate a "target" directory that contains the ESAPI jar file.

@@ Line 6: / Line 6: @@
    $ wget http://owaspantisamy.googlecode.com/files/antisamy-bin.1.3.jar
    $ mvn install:install-file -DgroupId=OWASP -DartifactId=AntiSamy -Dversion=1.2 -Dpackaging=jar -Dfile=antisamy-bin.1.3.jar
    $ mvn -Dmaven.test.skip=true package

← Older revision		Revision as of 03:17, 4 July 2009
Line 1:		Line 1:
−	~~==Simple Build Instructions==~~
−
	ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven].		ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven].

@@ Line 1: / Line 1: @@
-==Eclipse Setup==
+==Simple Build Instructions==
-* Get the [http://www.eclipse.org/downloads/ Ganymede release of Eclipse] - We recommend the version for Java EE developers
+ESAPI is easy to build yourself using [http://subversion.tigris.org/ Subversion] and [http://maven.apache.org/ Maven].
-==Importing the ESAPI Source==
+  $ mkdir ESAPI
-To import the ESAPI source code into your workspace, you can either download the source files in a zip file from [[::Category:OWASP_Enterprise_Security_API#Download_Now|here]] or download the latest trunk from the ESAPI SVN.
+  $ cd ESAPI
-'''The zip files containing the ESAPI source''' are official releases of the ESAPI.  They will be updated whenever major changes are made to the ESAPI, whether features are added/removed, or if ESAPI undergoes a major organizational change.  If you are planning on using the ESAPI's reference implementations and want to see ESAPI's source, but do not want to build your own JAR, you might download the ESAPI source zip file (available [[::Category:OWASP_Enterprise_Security_API#Download_Now|here]]).
+Maven will generate a "target" directory that contains the ESAPI jar file.
-'''The ESAPI trunk SVN''' contains the most up-to-date development version of ESAPI.  The trunk may contain different code from the pre-zipped source.  It may contain new features or be organized differently.  The trunk is a development version of the ESAPI, meaning that contributors to the ESAPI project are actively editing this code, so while all contributors are encouraged to run all test cases on the code before committing it, developers using this code should run their own tests to be sure the code is fully functional.  In addition, because the trunk code is in development, documentation regarding the ESAPI, especially Javadocs, may not be entirely accurate.
+To generate project reports use:
-===Source Code From a .zip===
+  $ mvn site
-While there are a few ways to import the ESAPI project using a zip file of its source code, I recommend following these instructions.  For the moment, I'll assume you are using Eclipse as your IDE.  More tutorials may come in the future for other IDEs.
+To generate documentation use:
-* Unzip file ESAPI source files to a directory of your choice.
+  $ mvn javadoc:jar
 __NOTOC__
 [[Category:OWASP Enterprise Security API]]

@@ Line 93: / Line 93: @@
 # Click "Apply" to save your build configuration
 # Click "Run" to run your configuration
 ''NOTE: Jars created through building are located in the directory called "target". ''

@@ Line 102: / Line 102: @@
 * Select the ''Arguments'' tab and enter a VM argument
 ** -Dorg.owasp.esapi.resources="<path to your esapi project>/test/testresources"
-* run tests and verify that they all pass ''NOTE: NOT ALL TESTS CURRENTLY PASS''
+* run tests and verify that they all pass
 ==Running Demo App==