XMLMetaData instance using an explicit DOM element
* as the configuration source, and requiring an explicit version indicator.
* The version should be the PublicID for the dtd or (worse) the dtd url.
*
* @param mmbClassName a String value
* @param resourceClassName a String value
* @param element an org.w3c.dom.Element value
* @param version a String value
*/
public XMLMetaData(String mmbClassName, String resourceClassName, Element element, String version)
{
super();
this.mmbClassName = mmbClassName;
this.resourceClassName = resourceClassName;
this.element = element;
versionString = version;
}
// MetaDataBuilder implementation --------------------------------
/**
* Constructs the Model MBean metadata. This implementation reads the
* document type definition from the beginning of the XML file and picks
* a corresponding XML builder based on the schema name. In case no
* document type is defined the latest schema builder for this JBossMX
* release is used.
*
* The SAX parser implementation is selected by default based on JAXP
* configuration. If you want to use JAXP to select the parser, you can
* set the system property "javax.xml.parsers.SAXParserFactory".
* For example, to use Xerces you might define:
*
* java -Djavax.xml.parsers.SAXParserFactory=org.apache.xerces.jaxp.SAXParserFactoryImpl ...
*
*
*
* In case you can't or don't want to use JAXP to configure the SAX parser
* implementation you can override the SAX parser implementation by setting
* an MBean descriptor field {@link XMBeanConstants#SAX_PARSER} to the
* parser class string value.
*
* @return initialized MBean info
* @throws NotCompliantMBeanException if there were errors building the
* MBean info from the given XML file.
*/
public MBeanInfo build() throws NotCompliantMBeanException
{
try
{
int version = NO_VERSION;
if (versionString == null)
{
// by default, let JAXP pick the SAX parser
SAXReader reader = new SAXReader();
// check if user wants to override the SAX parser property
if (properties.get(SAX_PARSER) != null)
{
try
{
reader.setXMLReaderClassName(getStringProperty(SAX_PARSER));
}
catch (SAXException e)
{
//Should log and ignore, I guess
} // end of try-catch
}
// by default we validate
reader.setValidation(true);
// the user can override the validation by setting the VALIDATE property
try
{
boolean validate = getBooleanProperty(XML_VALIDATION);
reader.setValidation(validate);
}
catch (IllegalPropertyException e)
{
// FIXME: log the exception (warning)
// fall through, use the default value
}
//supply it with our dtd locally.
reader.setEntityResolver(new JBossEntityResolver());
// get the element and start parsing...
Document doc = reader.read(url);
element = doc.getRootElement();
DocumentType type = doc.getDocType();
version = validateVersionString(type.getPublicID());
if (version == NO_VERSION)
{
version = validateVersionString(type.getSystemID());
} // end of if ()
}
else
{
version = validateVersionString(versionString);
} // end of else
if (element == null)
{
throw new IllegalStateException("No element supplied with explict version!");
}
// These are the known schemas for us. Pick the correct one based on
// schema or default to the latest.docURL.endsWith(JBOSSMX_XMBEAN_DTD_1_0)
if (version == JBOSS_XMBEAN_1_0 ||
version == JBOSS_XMBEAN_1_1 ||
version == JBOSS_XMBEAN_1_2)
{
// jboss_xmbean_1_0.dtd is the only implemented useful xmbean
return new JBossXMBean10(mmbClassName, resourceClassName, element, properties).build();
}
else
{
throw new NotCompliantMBeanException("Unknown xmbean type " + versionString);
} // end of else
}
catch (DocumentException e)
{
throw new JBossNotCompliantMBeanException("Error parsing the XML file, from XMLMetaData: ", e);
}
}
private int validateVersionString(String versionString)
{
if (PUBLIC_JBOSSMX_XMBEAN_DTD_1_0.equals(versionString))
{
return JBOSS_XMBEAN_1_0;
} // end of if ()
if (versionString != null && versionString.endsWith(JBOSSMX_XMBEAN_DTD_1_0))
{
return JBOSS_XMBEAN_1_0;
} // end of if ()
if (PUBLIC_JBOSSMX_XMBEAN_DTD_1_1.equals(versionString))
{
return JBOSS_XMBEAN_1_1;
} // end of if ()
if (versionString != null && versionString.endsWith(JBOSSMX_XMBEAN_DTD_1_1))
{
return JBOSS_XMBEAN_1_1;
} // end of if ()
if (PUBLIC_JBOSSMX_XMBEAN_DTD_1_2.equals(versionString))
{
return JBOSS_XMBEAN_1_2;
} // end of if ()
if (versionString != null && versionString.endsWith(JBOSSMX_XMBEAN_DTD_1_2))
{
return JBOSS_XMBEAN_1_2;
} // end of if ()
//There is nothing defined for jboss xmbean 1.2, so we can't recognize it.
return NO_VERSION;
}
}