| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <!-- Generated by Apache Maven Doxia Site Renderer 1.6 at 12 Dec 2015 --> |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> |
| <title>Apache Rampart – Developing Apache Rampart</title> |
| <style type="text/css" media="all"> |
| @import url("./css/maven-base.css"); |
| @import url("./css/maven-theme.css"); |
| @import url("./css/site.css"); |
| </style> |
| <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" /> |
| <meta name="Date-Revision-yyyymmdd" content="20151212" /> |
| <meta http-equiv="Content-Language" content="en" /> |
| |
| </head> |
| <body class="composite"> |
| <div id="banner"> |
| <a href="images/apache-rampart-logo.jpg" id="bannerLeft"> |
| Apache Rampart |
| </a> |
| <a href="http://www.apache.org" id="bannerRight"> |
| <img src="http://www.apache.org/images/asf_logo_wide.png" alt="$alt" /> |
| </a> |
| <div class="clear"> |
| <hr/> |
| </div> |
| </div> |
| <div id="breadcrumbs"> |
| |
| |
| <div class="xleft"> |
| <span id="publishDate">Last Published: 12 Dec 2015</span> |
| | <span id="projectVersion">Version: 1.6.3</span> |
| </div> |
| <div class="xright"> <a href="../core/" title="Apache Axis2/Java">Apache Axis2/Java</a> |
| |
| |
| </div> |
| <div class="clear"> |
| <hr/> |
| </div> |
| </div> |
| <div id="leftColumn"> |
| <div id="navcolumn"> |
| |
| |
| <h5>Apache Rampart</h5> |
| <ul> |
| <li class="none"> |
| <a href="index.html" title="Home">Home</a> |
| </li> |
| <li class="expanded"> |
| <a href="javascript:void(0)" title="Downloads">Downloads</a> |
| <ul> |
| <li class="none"> |
| <a href="download.html" title="Releases">Releases</a> |
| </li> |
| <li class="none"> |
| <strong>Source Code</strong> |
| </li> |
| </ul> |
| </li> |
| <li class="expanded"> |
| <a href="javascript:void(0)" title="Release Notes">Release Notes</a> |
| <ul> |
| <li class="none"> |
| <a href="release-notes/1.6.1.html" title="1.6.1">1.6.1</a> |
| </li> |
| <li class="none"> |
| <a href="release-notes/1.6.2.html" title="1.6.2">1.6.2</a> |
| </li> |
| <li class="none"> |
| <a href="release-notes/1.6.3.html" title="1.6.3">1.6.3</a> |
| </li> |
| </ul> |
| </li> |
| </ul> |
| <h5>Documentation</h5> |
| <ul> |
| <li class="none"> |
| <a href="quick-start.html" title="Getting Started">Getting Started</a> |
| </li> |
| <li class="none"> |
| <a href="samples.html" title="Samples">Samples</a> |
| </li> |
| <li class="none"> |
| <a href="http://wiki.apache.org/ws/FrontPage/Rampart/FAQ" class="externalLink" title="FAQ">FAQ</a> |
| </li> |
| <li class="none"> |
| <a href="rampartconfig-guide.html" title="Rampart Configuration">Rampart Configuration</a> |
| </li> |
| <li class="none"> |
| <a href="setting-up-sts.html" title="STS Configuration">STS Configuration</a> |
| </li> |
| <li class="none"> |
| <a href="developer-guide.html" title="Developer Guide">Developer Guide</a> |
| </li> |
| <li class="none"> |
| <a href="siteHowTo.html" title="Build the Site">Build the Site</a> |
| </li> |
| </ul> |
| <h5>Resources</h5> |
| <ul> |
| <li class="none"> |
| <a href="articles.html" title="Articles">Articles</a> |
| </li> |
| <li class="none"> |
| <a href="specifications.html" title="Specifications">Specifications</a> |
| </li> |
| <li class="none"> |
| <a href="apidocs/index.html" title="Online Javadocs">Online Javadocs</a> |
| </li> |
| </ul> |
| <h5>Project Information</h5> |
| <ul> |
| <li class="none"> |
| <a href="team-list.html" title="Project Team">Project Team</a> |
| </li> |
| <li class="none"> |
| <a href="http://issues.apache.org/jira/browse/Rampart" class="externalLink" title="Issue Tracking">Issue Tracking</a> |
| </li> |
| <li class="none"> |
| <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a> |
| </li> |
| <li class="none"> |
| <a href="http://svn.apache.org/viewvc/axis/axis2/java/rampart/" class="externalLink" title="Source Code">Source Code</a> |
| </li> |
| <li class="none"> |
| <a href="http://www.apache.org/licenses/" class="externalLink" title="License">License</a> |
| </li> |
| <li class="none"> |
| <a href="http://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsorship">Sponsorship</a> |
| </li> |
| <li class="none"> |
| <a href="http://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">Thanks</a> |
| </li> |
| <li class="none"> |
| <a href="http://www.apache.org/security/" class="externalLink" title="Security">Security</a> |
| </li> |
| </ul> |
| <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy"> |
| <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" /> |
| </a> |
| |
| |
| </div> |
| </div> |
| <div id="bodyColumn"> |
| <div id="contentBox"> |
| <!-- ~ Licensed to the Apache Software Foundation (ASF) under one |
| ~ or more contributor license agreements. See the NOTICE file |
| ~ distributed with this work for additional information |
| ~ regarding copyright ownership. The ASF licenses this file |
| ~ to you under the Apache License, Version 2.0 (the |
| ~ "License"); you may not use this file except in compliance |
| ~ with the License. You may obtain a copy of the License at |
| ~ |
| ~ http://www.apache.org/licenses/LICENSE-2.0 |
| ~ |
| ~ Unless required by applicable law or agreed to in writing, |
| ~ software distributed under the License is distributed on an |
| ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| ~ KIND, either express or implied. See the License for the |
| ~ specific language governing permissions and limitations |
| ~ under the License. --><html xmlns="http://www.w3.org/1999/xhtml"> |
| |
| |
| <h1>Developing Apache Rampart</h1> |
| |
| <p>This document provides information on how to use SVN to get an |
| SVN checkout/update, make commits to the repository, etc., in the |
| process of contributing to Apache projects (specifically Apache Rampart). |
| Instructions on configuring IDEs for development and using Maven to |
| build the project is also included here.</p> |
| |
| <div class="section"> |
| <h2><a name="Content"></a>Content</h2> |
| |
| <ul> |
| |
| <li><a href="#svn">Working with Subversion (SVN)</a></li> |
| |
| <li><a href="#checkout">Checkout Rampart from Subversion</a></li> |
| |
| <li><a href="#maven">Installing Maven 2</a></li> |
| |
| <li><a href="#ide">Configuring your IDE</a></li> |
| </ul> |
| <a name="svn" id="svn"></a> |
| |
| <div class="section"> |
| <h2><a name="Working_with_Subversion_SVN"></a>Working with Subversion (SVN)</h2> |
| |
| <p>The Rampart development team uses Subversion (SVN) for source |
| control. Subversion is a compelling replacement for CVS, developed |
| under the auspices of the Tigris community and licensed under an |
| Apache compatible license. To learn more about Subversion or to |
| download the latest distribution, visit the <a class="externalLink" href="http:///subversion.tigris.org" target="_blank">Subversion project |
| site</a>. If you are looking for guidance on setting up and |
| installing Subversion, please read the ASF <a class="externalLink" href="http://www.apache.org/dev/version-control.html" target="_blank">Source Code Repositories page</a>.</p> |
| <a name="checkout" id="checkout"></a> |
| |
| <div class="section"> |
| <h2><a name="Checkout_Axis2_from_Subversion"></a>Checkout Axis2 from Subversion</h2> |
| |
| <p>To check out the latest version of Rampart from the Foundation's |
| Subversion repository, you must use one of the following URLs |
| depending on your level of access to the Rampart source code:</p> |
| |
| <ul> |
| |
| <li><b>If you are not a committer:</b> <a class="externalLink" href="http://svn.apache.org/repos/asf/axis/axis2/java/rampart/trunk" target="_blank">http://svn.apache.org/repos/asf/axis/axis2/java/rampart/trunk</a></li> |
| |
| <li><b>If you are a committer:</b> <a class="externalLink" href="https://svn.apache.org/repos/asf/axis/axis2/java/rampart/trunk" target="_blank">https://svn.apache.org/repos/asf/axis/axis2/java/rampart/trunk</a></li> |
| </ul> |
| If you are a committer, make sure that you have selected an |
| svnpasswd. To do this, you must log into svn.apache.org. For more |
| information, please read the ASF <a class="externalLink" href="http://www.apache.org/dev/version-control.html" target="_blank">Source Code Repositories page</a>. |
| |
| <p>Once you have successfully installed Subversion, you can check |
| out Rampart trunk by following these steps:</p> |
| |
| <ol style="list-style-type: decimal"> |
| |
| <li>Run <b>svn co <repository URL> rampart</b> where |
| the repository URL is one of the URLs from the previous list.</li> |
| |
| <li>This step will check out the latest version of the Rampart Java |
| codebase to a directory named "rampart". The second parameter to the |
| <b>svn co</b> selects a directory to create on your local |
| machine. If you want to checkout Rampart to a different directory, |
| feel free to change rampart to any other directory name.</li> |
| |
| <li>To update your working copy to the latest version from the |
| repository, execute the <b>svn update</b> command.</li> |
| |
| <li>If you would like to submit a patch, you can execute |
| <b>svn diff</b> to create a unified diff for submission |
| to the Rampart JIRA issue tracker.</li> |
| </ol> |
| <a name="maven" id="maven"></a> |
| |
| <div class="section"> |
| <h2><a name="Installing_Maven_2"></a>Installing Maven 2</h2> |
| |
| <p>Rampart's build is based on Maven 2. Maven is a build system that |
| allows for the reuse of common build projects across multiple |
| projects. For information about obtaining, installing, and |
| configuring Maven 2, please see the <a class="externalLink" href="http://maven.apache.org" target="_blank">Maven project page</a>. |
| To use Maven to build the Axis2 project, Please install <a class="externalLink" href="http://maven.apache.org/download.html" target="_blank">Maven2</a> and follow instructions here - <a href="maven-help.html">Quick Guide to Maven for Axis 2.0</a></p>. |
| <a name="ide" id="ide"></a> |
| |
| <div class="section"> |
| <h2><a name="Configuring_your_IDE"></a>Configuring your IDE</h2> |
| |
| <p>The Rampart development team uses a variety of development tools |
| from vi to emacs to eclipse to Intellij/IDEA. The following section |
| is not an endorsement of a specific set of tools, it is simply |
| meant as a pointer to ease the process of getting started with |
| Rampart development.</p> |
| |
| <ul> |
| |
| <li><b>Intellij IDEA</b> - type <b>mvn |
| idea:idea</b>. Generates the necessary IDEA .ipr, .iml |
| and .iws project files</li> |
| |
| <li><b>Eclipse</b>- type <b>mvn eclipse:eclipse</b>. Then in Eclipse, setup a Classpath Variable |
| for MAVEN_REPO, and select File > Import > Existing Projects |
| into Workspace > Select root directory. Selecting the root of |
| the Rampart source discovers all the modules and allows them to be |
| imported as individual projects at once.</li> |
| </ul> |
| |
| </html> |
| </div> |
| </div> |
| <div class="clear"> |
| <hr/> |
| </div> |
| <div id="footer"> |
| <div class="xright"> |
| Copyright © 2005–2015 |
| <a href="http://www.apache.org">Apache Software Foundation</a>. |
| All rights reserved. |
| |
| </div> |
| <div class="clear"> |
| <hr/> |
| </div> |
| </div> |
| </body> |
| </html> |