/**
* This creates a new <code>{@link Document}</code> from an existing <code>InputStream</code> by
* letting a DOM parser handle parsing using the supplied stream.
*
* @param in <code>InputStream</code> to parse.
* @param validate <code>boolean</code> to indicate if validation should occur.
* @return <code>Document</code> - instance ready for use.
* @throws IOException when I/O error occurs.
* @throws JDOMException when errors occur in parsing.
*/
public Document getDocument(InputStream in, boolean validate) throws IOException, JDOMException {
try {
// Load the parser class
Class parserClass = Class.forName("org.apache.xerces.parsers.DOMParser");
Object parser = parserClass.newInstance();
// Set validation
Method setFeature =
parserClass.getMethod("setFeature", new Class[] {java.lang.String.class, boolean.class});
setFeature.invoke(
parser, new Object[] {"http://xml.org/sax/features/validation", new Boolean(validate)});
// Set namespaces true
setFeature.invoke(
parser, new Object[] {"http://xml.org/sax/features/namespaces", new Boolean(true)});
// Set the error handler
if (validate) {
Method setErrorHandler =
parserClass.getMethod("setErrorHandler", new Class[] {ErrorHandler.class});
setErrorHandler.invoke(parser, new Object[] {new BuilderErrorHandler()});
}
// Parse the document
Method parse = parserClass.getMethod("parse", new Class[] {org.xml.sax.InputSource.class});
parse.invoke(parser, new Object[] {new InputSource(in)});
// Get the Document object
Method getDocument = parserClass.getMethod("getDocument", null);
Document doc = (Document) getDocument.invoke(parser, null);
return doc;
} catch (InvocationTargetException e) {
Throwable targetException = e.getTargetException();
if (targetException instanceof org.xml.sax.SAXParseException) {
SAXParseException parseException = (SAXParseException) targetException;
throw new JDOMException(
"Error on line "
+ parseException.getLineNumber()
+ " of XML document: "
+ parseException.getMessage(),
e);
} else if (targetException instanceof IOException) {
IOException ioException = (IOException) targetException;
throw ioException;
} else {
throw new JDOMException(targetException.getMessage(), e);
}
} catch (Exception e) {
throw new JDOMException(e.getClass().getName() + ": " + e.getMessage(), e);
}
}
/**
* Look up an appropriate ComponentTester given an arbitrary Component-derived class. If the class
* is derived from abbot.tester.ComponentTester, instantiate one; if it is derived from
* java.awt.Component, return a matching Tester. Otherwise return abbot.tester.ComponentTester.
*
* <p>
*
* @throws ClassNotFoundException If the given class can't be found.
* @throws IllegalArgumentException If the tester cannot be instantiated.
*/
protected ComponentTester resolveTester(String className) throws ClassNotFoundException {
Class testedClass = resolveClass(className);
if (Component.class.isAssignableFrom(testedClass))
return ComponentTester.getTester(testedClass);
else if (ComponentTester.class.isAssignableFrom(testedClass)) {
try {
return (ComponentTester) testedClass.newInstance();
} catch (Exception e) {
String msg =
"Custom ComponentTesters must provide "
+ "an accessible no-args Constructor: "
+ e.getMessage();
throw new IllegalArgumentException(msg);
}
}
String msg = "The given class '" + className + "' is neither a Component nor a ComponentTester";
throw new IllegalArgumentException(msg);
}
public WhatsNew(AbstractProjectViewer pv, boolean onlyShowCurrentVersion)
throws GeneralException {
super(pv);
String wn = Environment.getProperty(Constants.WHATS_NEW_VERSION_VIEWED_PROPERTY_NAME);
if (wn == null) {
wn = "0";
}
// Get the current whats new version (i.e. old).
Version lastWhatsNewVersion = new Version(wn);
boolean betasAllowed =
Environment.getUserProperties()
.getPropertyAsBoolean(Constants.OPTIN_TO_BETA_VERSIONS_PROPERTY_NAME);
try {
String whatsNew = Environment.getResourceFileAsString(Constants.WHATS_NEW_FILE);
// Load up all the whats new for greater versions.
Element root = JDOMUtils.getStringAsElement(whatsNew);
java.util.List verEls = JDOMUtils.getChildElements(root, XMLConstants.version, false);
// Assume they are in the right order
// TODO: Enforce the order and/or sort.
for (int i = 0; i < verEls.size(); i++) {
Element vEl = (Element) verEls.get(i);
String id = JDOMUtils.getAttributeValue(vEl, XMLConstants.id, true);
Version v = new Version(id);
/*
if ((v.isBeta ())
&&
(!betasAllowed)
)
{
// Ignore, the user isn't interested in betas.
continue;
}
*/
if ((lastWhatsNewVersion.isNewer(v))
|| ((onlyShowCurrentVersion) && (v.isSame(Environment.getQuollWriterVersion())))) {
String c = WhatsNewComponentProvider.class.getName();
int ind = c.lastIndexOf(".");
if (ind > 0) {
c = c.substring(0, ind);
}
WhatsNewComponentProvider compProv = null;
String cl = JDOMUtils.getAttributeValue(vEl, XMLConstants.clazz, false);
if (!cl.equals("")) {
Class clz = null;
try {
clz = Class.forName(cl);
if (WhatsNewComponentProvider.class.isAssignableFrom(clz)) {
compProv = (WhatsNewComponentProvider) clz.newInstance();
}
} catch (Exception e) {
}
}
// This is a version we are interested in.
java.util.List itemEls =
JDOMUtils.getChildElements(vEl, WhatsNewItem.XMLConstants.root, true);
java.util.List<WhatsNewItem> its = new ArrayList();
for (int j = 0; j < itemEls.size(); j++) {
Element itEl = (Element) itemEls.get(j);
WhatsNewItem it = new WhatsNewItem(itEl, compProv, pv);
if (it.onlyIfCurrentVersion) {
if (!Environment.getQuollWriterVersion().isSame(v)) {
continue;
}
}
if ((it.description == null) && (it.component == null)) {
Environment.logMessage(
"Whats new item has no description or component, referenced by: "
+ JDOMUtils.getPath(itEl));
continue;
}
its.add(it);
}
if (its.size() > 0) {
this.items.put(v, its);
}
}
}
} catch (Exception e) {
throw new GeneralException("Unable to init whats new", e);
}
}