14.01.2013 Views

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

2.1.3. Which Files to Version?<br />

A popular open source version control system that meets all of the above requirements is<br />

SubVersion (also known as SVN) . SubVersion has been built by the same community<br />

that is responsible for CVS. It is intended as a replacement for CVS, keeping all the good<br />

things of CVS, and fixing the bad things (like the absence of an atomic commit).<br />

TortoiseSVN is an excellent stand-alone SubVersion GUI for the Windows platform,<br />

nicely integrated with MS Windows Explorer. JDeveloper integration is also available.<br />

SubVersion Home Page. Overview, documentation and download.<br />

HTUhttp://subversion.tigris.org/UTH<br />

TortoiseSVN Home Page. Overview, documentation and download.<br />

HTUhttp://tortoisesvn.tigris.org/UTH<br />

Using JDeveloper with SubVersion. Developers guide and installation<br />

instructions.<br />

HTUhttp://www.oracle.com/technology/products/jdev/htdocs/partners/addins/exchange<br />

/subversion/subversion.htmlUTH<br />

The <strong>JHeadstart</strong> team has succesfully used SubVersion and TortoiseSVN on a number of<br />

projects. This does not imply you should make the same choice. Version control is no<br />

rocket science, any system that meets the above requirements will do the job.<br />

We recommend to version all files in your project, except for<br />

• derived files like all compiled Java classes and XML and property files that are<br />

copied to the classpath. In SubVersion, the easiest way to exclude these files is by<br />

adding the root directory of the classpath (typically the /classes directory) to the<br />

ignore list. This can be done by a right-mouse-click on the folder, and then<br />

choose Tortoise SVN -> Add to Ignore List …<br />

• files in the temporary directory created by ADF Faces. When running your<br />

application in JDeveloper, a temp directory will be created under the WEB-INF<br />

directory, which holds cached ADF Faces files like images and stylesheets. This<br />

directory is not required to run your application and does not need to be<br />

versioned.<br />

• the files created by JDeveloper in the root: appname-data-sources.xml, appnamejazn-data.xml,<br />

appname-oc4j-app.log, appname-oc4j-app.xml and<br />

application.log. If you are using JAAS-JAZN authorization, you do might want<br />

to version appname-jazn-data.xml since it holds the users and roles you have<br />

defined in JDeveloper for the project.<br />

• the faces-config diagram files, with extension “.oxd_faces”. When generating<br />

your application with <strong>JHeadstart</strong>, the faces-config diagram typically looks rather<br />

messy, so unless you spend some time in cleaning up the diagram, it doesn’t<br />

make a lot of sense to version these files. They are usually created in a separate<br />

folder (/model by default), so you can exlude the whole folder from versioning.<br />

When using TortoiseSVN, the “Add to Ignore List” option in Windows Explorer is only<br />

available on unversioned folders directly below a versioned folder. When committing a<br />

project for the first time, it is easier to exclude folders using the right-mouse-click popup<br />

menu in the Commit dialog, as shown in the screen shot below.<br />

2 - 4 Getting Started <strong>JHeadstart</strong> <strong>Developer's</strong> <strong>Guide</strong>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!