Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Redistribution and use of this software and associated documentation ("Software"), with or
* without modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain copyright statements and notices. Redistributions
* must also contain a copy of this document.
*
* 2. Redistributions in binary form must reproduce the above copyright notice, this list of
* conditions and the following disclaimer in the documentation and/or other materials provided with
* the distribution.
*
* 3. The name "Exolab" must not be used to endorse or promote products derived from this Software
* without prior written permission of Intalio, Inc. For written permission, please contact
* [email protected].
*
* 4. Products derived from this Software may not be called "Exolab" nor may "Exolab" appear in
* their names without prior written permission of Intalio, Inc. Exolab is a registered trademark of
* Intalio, Inc.
*
* 5. Due credit should be given to the Exolab Project (http://www.exolab.org/).
*
* THIS SOFTWARE IS PROVIDED BY INTALIO, INC. AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESSED OR
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
* FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL INTALIO, INC. OR ITS
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
* WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
* Copyright 2001-2002 (C) Intalio, Inc. All Rights Reserved.
*/
package org.exolab.javasource;
import java.io.File;
import java.io.FileWriter;
import java.util.Enumeration;
import java.util.SortedSet;
import java.util.TreeSet;
import java.util.Vector;
/**
* A representation of the Java Source code for a Java compilation unit. This is a useful utility
* when creating in memory source code. This package was modelled after the Java Reflection API as
* much as possible to reduce the learning curve.
*
* @author Gary Shea
* @version $Revision$ $Date: 2005-03-05 06:42:06 -0700 (Sat, 05 Mar 2005) $
*/
public final class JCompUnit {
/**
* Initial size for {@link StringBuilder} instances.
*/
private static final int INITIAL_STRING_BUILDER_SIZE = 32;
/**
* The Id for Source control systems I needed to break the String to prevent CVS from expanding it
* here! ;-)
*/
private static final String DEFAULT_HEADER = "$" + "Id$";
/** Public header. */
private static final String[] PUBLIC_HEADER = {" //-----------------------------/",
" //- Public Class / Interface -/", "//-----------------------------/",};
/** Private header. */
private static final String[] NON_PUBLIC_HEADER = {" //-------------------------------------/",
" //- Non-Public Classes / Interfaces -/", "//-------------------------------------/",};
/** JavaDoc comment for this compilation unit. */
private JComment _header = null;
/** The package for this JCompUnit. */
private final String _packageName;
/** The file to which this JCompUnit will be written. */
private final String _fileName;
/** The set of top-level classes that live in this compilation unit. */
private final Vector _classes = new Vector();
/** The set of top-level interfaces that live in this compilation unit. */
private final Vector _interfaces = new Vector();
/**
* Creates a new JCompUnit.
*
* @param packageName The name of the package for this JCompUnit. If packageName is null or empty,
* no 'package' line will be generated.
* @param fileName The name of the file to which this JCompUnit will be written.
*/
public JCompUnit(final String packageName, final String fileName) {
_packageName = packageName;
_fileName = fileName;
}
/**
* Creates a new JCompUnit with the given JClass (which must have been created with either a full
* class name or package/local name) as the public class. Package and file name are taken from
* jClass.
*
* @param jClass The public class for this JCompUnit.
*/
public JCompUnit(final JClass jClass) {
this(jClass.getPackageName(), jClass.getLocalName() + ".java");
// The outer name is the package plus the simple name of the
// outermost enclosing class. The file name is just the
// simple name of the outermost enclosing class, so the
// package name part must be stripped off.
// Commented out until inner-class support has been added.
// kvisco - 20021211
//
// String outer = jClass.getOuterName();
// int lastDot = outer.lastIndexOf(".");
// String filePrefix;
// if (lastDot != -1) {
// filePrefix = outer.substring (lastDot + 1);
// } else {
// filePrefix = outer;
// }
_classes.add(jClass);
}
/**
* Creates a new JCompUnit with the given JInterface as public interface. Package and file name
* are taken from jInterface.
*
* @param jInterface The public interface for this JCompUnit.
*/
public JCompUnit(final JInterface jInterface) {
this(jInterface.getPackageName(), jInterface.getLocalName() + ".java");
_interfaces.add(jInterface);
}
/**
* Sets the header comment for this JCompUnit.
*
* @param comment The comment to display at the top of the source file when printed.
*/
public void setHeader(final JComment comment) {
_header = comment;
}
/**
* Adds the given JStructure (either a JInterface or a JClass) to this JCompUnit.
*
* @param jStructure The JStructure to add.
*/
public void addStructure(final JStructure jStructure) {
if (jStructure instanceof JInterface) {
addInterface((JInterface) jStructure);
} else if (jStructure instanceof JClass) {
addClass((JClass) jStructure);
} else {
String err = "Unknown JStructure subclass '" + jStructure.getClass().getName() + "'.";
throw new IllegalArgumentException(err);
}
}
/**
* Adds a JClass to be printed in this file.
*
* @param jClass The JClass to be printed in this file.
*/
public void addClass(final JClass jClass) {
_classes.add(jClass);
}
/**
* Adds a JInterface to be printed in this file.
*
* @param jInterface The JInterface to be printed in this file.
*/
public void addInterface(final JInterface jInterface) {
_interfaces.add(jInterface);
}
/**
* Returns a array of String containing all imported classes/packages, also imports within the
* same package of this object.
*
* @return A array of String containing all import classes/packages, also imports within the same
* package of this object.
*/
public SortedSet getImports() {
SortedSet allImports = new TreeSet();
// add imports from classes
for (JClass jClass : _classes) {
Enumeration enumeration = jClass.getImports();
while (enumeration.hasMoreElements()) {
allImports.add(enumeration.nextElement());
}
}
for (JInterface jInterface : _interfaces) {
Enumeration enumeration = jInterface.getImports();
while (enumeration.hasMoreElements()) {
allImports.add(enumeration.nextElement());
}
}
return allImports;
}
/**
* Returns the name of the file that this JCompUnit would be printed to, given a call to
* {@link #print(String, String)}, or if destDir is null, a call to {@link #print()}.
*
* @param destDir The destination directory. This may be null.
* @return The name of the file that this JCompUnit would be printed to.
*/
public String getFilename(final String destDir) {
// -- Convert Java package to path string
String javaPackagePath = "";
if (_packageName != null && !_packageName.isEmpty()) {
javaPackagePath = _packageName.replace('.', File.separatorChar);
}
// -- Create fully qualified path (including 'destDir') to file
File pathFile;
if (destDir == null) {
pathFile = new File(javaPackagePath);
} else {
pathFile = new File(destDir, javaPackagePath);
}
if (!pathFile.exists()) {
pathFile.mkdirs();
}
// -- Prefix filename with path
String filename = _fileName;
final String pathStr = pathFile.toString();
if (!pathStr.isEmpty()) {
filename = pathStr + File.separator + filename;
}
return filename;
}
/**
* Returns the name of the package that this JCompUnit is a member of.
*
* @return The name of the package that this JCompUnit is a member of, or null if there is no
* current package name defined.
*/
public String getPackageName() {
return _packageName;
}
/**
* Prints the source code for this JClass in the current directory with the default line seperator
* of the the runtime platform.
*
* @see #print(String, String)
*/
public void print() {
print(null, null);
}
/**
* Prints the source code for this JClass with the default line seperator of the the runtime
* platform.
*
* @param destDir The destination directory to use as the root directory for source generation.
*
* @see #print(String, String)
*/
public void print(final String destDir) {
print(destDir, null);
}
/**
* Prints the source code for this JCompUnit using the provided root directory and line separator.
*
* @param destDir The destination directory to use as the root directory for source generation.
* @param lineSeparator The line separator to use at the end of each line. If null, then the
* default line separator for the runtime platform will be used.
*/
public void print(final String destDir, final String lineSeparator) {
// -- open output file
String filename = getFilename(destDir);
File file = new File(filename);
JSourceWriter jsw = null;
try {
jsw = new JSourceWriter(new FileWriter(file));
} catch (java.io.IOException ioe) {
System.out.println("unable to create compilation unit file: " + filename);
return;
}
if (lineSeparator == null) {
jsw.setLineSeparator(System.getProperty("line.separator"));
} else {
jsw.setLineSeparator(lineSeparator);
}
print(jsw);
jsw.flush();
jsw.close();
}
/**
* Prints the source code for this JClass to the provided JSourceWriter.
*
* @param jsw The JSourceWriter to print to.
*/
public void print(final JSourceWriter jsw) {
// Traverse the nested class and interface hiararchy and
// update the names to match the compilation unit.
// -- write file header
if (_header != null) {
_header.print(jsw);
} else {
jsw.writeln("/*");
jsw.writeln(" * " + DEFAULT_HEADER);
jsw.writeln("*/");
}
jsw.writeln();
jsw.flush();
// -- print package name
if ((_packageName != null) && (_packageName.length() > 0)) {
String buffer = new StringBuilder(INITIAL_STRING_BUILDER_SIZE).append("package ")
.append(_packageName).append(';').toString();
jsw.writeln(buffer);
jsw.writeln();
}
// -- print imports
jsw.writeln(" //---------------------------------------------/");
jsw.writeln(" //- Imported classes, interfaces and packages -/");
jsw.writeln("//---------------------------------------------/");
jsw.writeln();
SortedSet allImports = getImports();
String compUnitPackage = getPackageName();
for (String importName : allImports) {
String importsPackage = JNaming.getPackageFromClassName(importName);
if (importsPackage != null && !importsPackage.equals(compUnitPackage)) {
jsw.write("import ");
jsw.write(importName);
jsw.writeln(';');
}
}
jsw.writeln();
// Print the public elements, interfaces first, then classes.
// There should only be one public element, but if there are
// more we let the compiler catch it.
printStructures(jsw, true);
// Print the remaining non-public elements, interfaces first.
printStructures(jsw, false);
jsw.flush();
}
/**
* Print the source code for the contained JClass objects.
*
* @param jsw The JSourceWriter to print to.
* @param printPublic If true, print only public classes; if false, print only non-public classes.
*/
public void printStructures(final JSourceWriter jsw, final boolean printPublic) {
// -- print class information
// -- we need to add some JavaDoc API adding comments
boolean isFirst = true;
// SortedSet interfaceList = interfaces.sortedOnFullName();
for (JInterface jInterface : _interfaces) {
if (jInterface.getModifiers().isPublic() == printPublic) {
if (isFirst) {
String[] header = printPublic ? PUBLIC_HEADER : NON_PUBLIC_HEADER;
for (String headerEntry : header) {
jsw.writeln(headerEntry);
}
jsw.writeln();
isFirst = false;
}
jInterface.print(jsw, true);
jsw.writeln();
}
}
// SortedSet classList = classes.sortedOnFullName();
for (JClass jClass : _classes) {
if (jClass.getModifiers().isPublic() == printPublic) {
if (isFirst) {
String[] header = printPublic ? PUBLIC_HEADER : NON_PUBLIC_HEADER;
for (int j = 0; j < header.length; ++j) {
jsw.writeln(header[j]);
}
jsw.writeln();
isFirst = false;
}
jClass.print(jsw, true);
jsw.writeln();
}
}
}
}
