If I try and run Hibernate when not connected to the internet I get the folowing error:

problem parsing configuration/hibernate.cfg.xml
org.dom4j.DocumentException: Error on line 2 of document : External entity not found: "http://hibernate.sf.net/hibernate-configuration-2.0.dtd". Nested exception: External entity not found: "http://hibernate.sf.net/hibernate-configuration-2.0.dtd".
at org.dom4j.io.SAXReader.read(SAXReader.java:355)
TestRunner.java:182).....<cut>

I can change the <!DOCTYPE from a PUBLIC to SYSTEM and it works, but only if the dtd is in the same directory.

Can anybody show me how to get this working with a relative path to the dtd?

Martin

This is ususly caused by you DTD DOCTYPE not being in the correct format. It uses this to find it on the classpath then looks on the net if its not found. Post the DOCTYPE you are using.

Here is my dtd :

<?xml version='1.0' encoding='utf-8'?>

<!-- Hibernate Mapping DTD.

<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 2.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">

An instance of this XML document may contain mappings for an arbitrary
number of classes. The class mappings may contain associations to classes
mapped in the same document or in another document. No class may be
mapped more than once. Each document may also contains mappings for an
arbitrary number of toplevel collections. Toplevel collection roles may
be referenced by later class and collection mappings in the same document.
(They must be declared before they are used.)

-->

<!-- The document root. -->

<!ELEMENT hibernate-mapping (meta*, import*, class*, query*)>
<!ATTLIST hibernate-mapping schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST hibernate-mapping default-cascade (none|save-update|all) "none">
<!ATTLIST hibernate-mapping auto-import (true|false) "true">

<!-- An explicit query language "import" -->

<!ELEMENT import EMPTY>
<!ATTLIST import class CDATA #REQUIRED>
<!ATTLIST import rename CDATA #IMPLIED> <!-- default: unqualified class name -->

<!-- Root of an entity class hierarchy. Entities have their own tables. -->

<!ELEMENT class (
meta*,
jcs-cache?,
(id|composite-id),
discriminator?,
(version|timestamp)?,
(property|many-to-one|one-to-one|component|dynabean|any|map|set|list|bag|idbag|array|primitive-array)*,
((subclass*)|(joined-subclass*))
)>
<!ATTLIST class name CDATA #REQUIRED>
<!ATTLIST class table CDATA #IMPLIED> <!-- default: unqualified classname -->
<!ATTLIST class schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST class proxy CDATA #IMPLIED> <!-- default: no proxy interface -->
<!ATTLIST class discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none -->
<!ATTLIST class mutable (true|false) "true">
<!ATTLIST class polymorphism (implicit|explicit) "implicit">
<!ATTLIST class persister CDATA #IMPLIED>
<!ATTLIST class dynamic-update (true|false) "false">

<!-- Declares the id type, column and generation algorithm for an entity class.
If a name attribut is given, the id is exposed to the application through the
named property of the class. If not, the id is only exposed to the application
via Session.getIdentifier()-->

<!ELEMENT id (meta*, column*, generator)>
<!ATTLIST id name CDATA #IMPLIED>
<!ATTLIST id column CDATA #IMPLIED>
<!ATTLIST id type CDATA #IMPLIED>
<!ATTLIST id length CDATA #IMPLIED>
<!ATTLIST id unsaved-value CDATA "null"> <!-- any|none|null|0|-1|... -->

<!-- A composite key may be modelled by a java class with a property for each
key column. The class must implement java.io.Serializable and reimplement equals()
and hashCode(). -->

<!ELEMENT composite-id ( (key-property|key-many-to-one)+ )>
<!ATTLIST composite-id class CDATA #IMPLIED>
<!ATTLIST composite-id name CDATA #IMPLIED>
<!ATTLIST composite-id unsaved-value (any|none) "none">

<!-- Polymorphic data requires a column holding a class discriminator value. This
value is not directly exposed to the application. -->

<!ELEMENT discriminator (column?)>
<!ATTLIST discriminator column CDATA #IMPLIED> <!-- default: "class"|none -->
<!ATTLIST discriminator type CDATA "string">
<!ATTLIST discriminator not-null (true|false) "true">
<!ATTLIST discriminator length CDATA #IMPLIED>
<!ATTLIST discriminator force (true|false) "false">

<!-- Versioned data requires a column holding a version number. This is exposed to the
application through a property of the Java class. -->

<!ELEMENT version EMPTY>
<!ATTLIST version name CDATA #REQUIRED>
<!ATTLIST version column CDATA #IMPLIED>
<!ATTLIST version type CDATA "integer">

<!ELEMENT timestamp EMPTY>
<!ATTLIST timestamp name CDATA #REQUIRED>
<!ATTLIST timestamp column CDATA #IMPLIED>

<!-- Subclass declarations are nested beneath the root class declaration to achieve
polymorphic persistence. -->

<!ELEMENT subclass (
meta*,
(property|many-to-one|one-to-one|component|any|map|set|list|bag|idbag|array|primitive-array)*,
subclass*
)>
<!ATTLIST subclass name CDATA #REQUIRED>
<!ATTLIST subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface -->
<!ATTLIST subclass discriminator-value CDATA #IMPLIED> <!-- default: unqualified class name | none -->
<!ATTLIST subclass dynamic-update (true|false) "false">
<!ATTLIST subclass import CDATA #IMPLIED>

<!-- Joined subclasses are used for the normalized table-per-subclass mapping strategy -->

<!ELEMENT joined-subclass (
meta*,
key,
(property|many-to-one|one-to-one|component|any|map|set|list|bag|idbag|array|primitive-array)*,
joined-subclass*
)>
<!ATTLIST joined-subclass name CDATA #REQUIRED>
<!ATTLIST joined-subclass proxy CDATA #IMPLIED> <!-- default: no proxy interface -->
<!ATTLIST joined-subclass table CDATA #IMPLIED> <!-- default: unqualified class name -->
<!ATTLIST joined-subclass schema CDATA #IMPLIED>
<!ATTLIST joined-subclass dynamic-update (true|false) "false">
<!ATTLIST joined-subclass import CDATA #IMPLIED>

<!-- Property of an entity class or component, component-element, composite-id, etc.
JavaBeans style properties are mapped to table columns. -->

<!ELEMENT property (meta*,column*)>
<!ATTLIST property name CDATA #REQUIRED>
<!ATTLIST property type CDATA #IMPLIED>
<!ATTLIST property column CDATA #IMPLIED>
<!ATTLIST property length CDATA #IMPLIED>
<!ATTLIST property not-null (true|false) "false">
<!ATTLIST property unique (true|false) "false">
<!ATTLIST property update (true|false) "true"> <!-- only supported for properties of a class (not component) -->
<!ATTLIST property insert (true|false) "true"> <!-- only supported for properties of a class (not component) -->

<!-- Declares an association between two entities (Or from a component, component element,
etc. to an entity). -->

<!ELEMENT many-to-one (meta*,column*)>
<!ATTLIST many-to-one name CDATA #REQUIRED>
<!ATTLIST many-to-one class CDATA #IMPLIED>
<!ATTLIST many-to-one column CDATA #IMPLIED>
<!ATTLIST many-to-one not-null (true|false) "false">
<!ATTLIST many-to-one unique (true|false) "false">
<!ATTLIST many-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST many-to-one outer-join (true|false|auto) "auto">
<!ATTLIST many-to-one update (true|false) "true"> <!-- only supported for many-to-one of a class (not component) -->
<!ATTLIST many-to-one insert (true|false) "true"> <!-- only supported for many-to-one of a class (not component) -->

<!-- Declares a one-to-one association between two entities (Or from a component,
component element, etc. to an entity). -->

<!ELEMENT one-to-one (meta*)>
<!ATTLIST one-to-one name CDATA #REQUIRED>
<!ATTLIST one-to-one class CDATA #IMPLIED>
<!ATTLIST one-to-one cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST one-to-one outer-join (true|false|auto) "auto">
<!ATTLIST one-to-one constrained (true|false) "false">

<!-- A property embedded in a composite identifier or map index (always not-null). -->

<!ELEMENT key-property (column*)>
<!ATTLIST key-property name CDATA #REQUIRED>
<!ATTLIST key-property type CDATA #IMPLIED>
<!ATTLIST key-property column CDATA #IMPLIED>
<!ATTLIST key-property length CDATA #IMPLIED>

<!-- A many-to-one association embedded in a composite identifier or map index
(always not-null, never cascade). -->

<!ELEMENT key-many-to-one (column*)>
<!ATTLIST key-many-to-one name CDATA #REQUIRED>
<!ATTLIST key-many-to-one class CDATA #IMPLIED>
<!ATTLIST key-many-to-one column CDATA #IMPLIED>

<!-- An "any" association is a polymorphic association to any table with
the given identifier type. The first listed column is a VARCHAR column
holding the name of the class (for that row). -->

<!ELEMENT any (column, column+)>
<!ATTLIST any id-type CDATA #REQUIRED>
<!ATTLIST any meta-type CDATA #IMPLIED> <!--- default: Hibernate.CLASS -->
<!ATTLIST any name CDATA #REQUIRED>
<!ATTLIST any cascade (none|save-update|all) "none">

<!-- A component is a user-defined class, persisted along with its containing entity
to the table of the entity class. JavaBeans style properties of the component are
mapped to columns of the table of the containing entity. A null component reference
is mapped to null values in all columns and vice versa. Components do not support
shared reference semantics. -->

<!ELEMENT component (
parent?,
(property|many-to-one|one-to-one|component|dynabean|any|map|set|list|bag|array|primitive-array)*
)>
<!ATTLIST component class CDATA #IMPLIED>
<!ATTLIST component name CDATA #REQUIRED>
<!ATTLIST component update (true|false) "true">
<!ATTLIST component insert (true|false) "true">

<!ELEMENT dynabean (
(property|many-to-one|one-to-one|component|dynabean|any|map|set|list|bag|array|primitive-array)*
)>
<!ATTLIST dynabean dynaclass CDATA #REQUIRED>
<!ATTLIST dynabean name CDATA #REQUIRED>
<!ATTLIST dynabean update (true|false) "true">
<!ATTLIST dynabean insert (true|false) "true">

<!-- The parent element maps a property of the component class as a pointer back to
the owning entity. -->

<!ELEMENT parent EMPTY>
<!ATTLIST parent name CDATA #REQUIRED>

<!-- Collection declarations nested inside a class declaration indicate a foreign key
relationship from the collection table to the enclosing class. -->

<!ELEMENT map (
meta*,
jcs-cache?,
key,
(index|composite-index|index-many-to-many|index-many-to-any),
(element|one-to-many|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST map name CDATA #REQUIRED>
<!ATTLIST map table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST map schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST map lazy (true|false) "false">
<!ATTLIST map inverse (true|false) "false">
<!ATTLIST map sort CDATA #IMPLIED> <!-- unsorted|natural|"comparator class", default: unsorted -->
<!ATTLIST map cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST map order-by CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST map where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT set (
meta*,
jcs-cache?,
key,
(element|one-to-many|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST set name CDATA #REQUIRED>
<!ATTLIST set table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST set schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST set lazy (true|false) "false">
<!ATTLIST set sort CDATA "unsorted"> <!-- unsorted|natural|"comparator class" -->
<!ATTLIST set inverse (true|false) "false">
<!ATTLIST set cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST set order-by CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST set where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT bag (
meta*,
jcs-cache?,
key,
(element|one-to-many|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST bag name CDATA #REQUIRED>
<!ATTLIST bag table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST bag schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST bag lazy (true|false) "false">
<!ATTLIST bag inverse (true|false) "false">
<!ATTLIST bag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST bag order-by CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST bag where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT idbag (
meta*,
jcs-cache?,
collection-id,
key,
(element|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST idbag name CDATA #REQUIRED>
<!ATTLIST idbag table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST idbag schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST idbag lazy (true|false) "false">
<!ATTLIST idbag cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST idbag order-by CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST idbag where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT list (
meta*,
jcs-cache?,
key,
index,
(element|one-to-many|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST list name CDATA #REQUIRED>
<!ATTLIST list table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST list schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST list lazy (true|false) "false">
<!ATTLIST list inverse (true|false) "false">
<!ATTLIST list cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST list where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT array (
meta*,
jcs-cache?,
key,
index,
(element|one-to-many|many-to-many|composite-element|many-to-any)
)>
<!ATTLIST array name CDATA #REQUIRED>
<!ATTLIST array table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST array schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST array element-class CDATA #IMPLIED>
<!ATTLIST array cascade (none|all|save-update|delete) #IMPLIED> <!-- default: none -->
<!ATTLIST array where CDATA #IMPLIED> <!-- default: none -->

<!ELEMENT primitive-array (meta*, jcs-cache?, key, index, element)>
<!ATTLIST primitive-array name CDATA #REQUIRED>
<!ATTLIST primitive-array table CDATA #IMPLIED> <!-- default: name -->
<!ATTLIST primitive-array schema CDATA #IMPLIED> <!-- default: none -->
<!ATTLIST primitive-array where CDATA #IMPLIED> <!-- default: none -->

<!-- Declares the element type of a collection of basic type -->

<!ELEMENT element (column*)>
<!ATTLIST element column CDATA #IMPLIED>
<!ATTLIST element type CDATA #REQUIRED>
<!ATTLIST element length CDATA #IMPLIED>
<!ATTLIST element not-null (true|false) "false">
<!ATTLIST element unique (true|false) "false">

<!-- One to many association. This tag declares the entity-class
element type of a collection and specifies a one-to-many relational model -->

<!ELEMENT one-to-many EMPTY>
<!ATTLIST one-to-many class CDATA #REQUIRED>
<!-- No column declaration attributes required in this case. The primary
key column of the associated class is already mapped elsewhere.-->

<!-- Many to many association. This tag declares the entity-class
element type of a collection and specifies a many-to-many relational model -->

<!ELEMENT many-to-many (meta*,column*)>
<!ATTLIST many-to-many class CDATA #REQUIRED>
<!ATTLIST many-to-many column CDATA #IMPLIED>
<!ATTLIST many-to-many outer-join (true|false|auto) "auto">
<!-- unique makes no sense here since it would make the association one-to-many -->

<!-- A composite element allows a collection to hold instances of an arbitrary
class, without the requirement of joining to an entity table. Composite elements
have component semantics - no shared references and ad hoc null value semantics.
Composite elements may not hold nested collections. -->

<!ELEMENT composite-element (
parent?,
(property|many-to-one|nested-composite-element)*
)>
<!ATTLIST composite-element class CDATA #REQUIRED>

<!ELEMENT nested-composite-element (
parent?,
(property|many-to-one|nested-composite-element)*
)>
<!ATTLIST nested-composite-element class CDATA #REQUIRED>
<!ATTLIST nested-composite-element name CDATA #REQUIRED>

<!-- Declares the type, column name (and, in the case of toplevel collections,
an id generation strategy) for the key of a collection table. These keys are
never exposed to the application. -->

<!ELEMENT key (column*)>
<!ATTLIST key column CDATA #IMPLIED>

<!-- Declares the type and column mapping for a collection index (array or
list index, or key of a map). -->

<!ELEMENT index (column*)>
<!ATTLIST index column CDATA #IMPLIED>
<!ATTLIST index type CDATA #IMPLIED> <!-- required for maps -->
<!ATTLIST index length CDATA #IMPLIED>

<!-- Many to many association mapped to the key of a map. ie. a map keyed
on entities. -->

<!ELEMENT index-many-to-many (column*)>
<!ATTLIST index-many-to-many class CDATA #REQUIRED>
<!ATTLIST index-many-to-many column CDATA #IMPLIED>

<!-- Composite index of a map ie. a map keyed on components. -->

<!ELEMENT composite-index ( (key-property|key-many-to-one)+ )>
<!ATTLIST composite-index class CDATA #REQUIRED>

<!-- A "many to any" defines a polymorphic association to any table
with the given identifier type. The first listed column is a VARCHAR column
holding the name of the class (for that row). -->

<!ELEMENT many-to-any (column, column+)>
<!ATTLIST many-to-any id-type CDATA #REQUIRED>
<!ATTLIST many-to-any meta-type CDATA #IMPLIED> <!--- default: Hibernate.CLASS -->

<!ELEMENT index-many-to-any (column, column+)>
<!ATTLIST index-many-to-any id-type CDATA #REQUIRED>
<!ATTLIST index-many-to-any meta-type CDATA #IMPLIED> <!--- default: Hibernate.CLASS -->

<!ELEMENT collection-id (meta*, column*, generator)>
<!ATTLIST collection-id column CDATA #REQUIRED>
<!ATTLIST collection-id type CDATA #REQUIRED>
<!ATTLIST collection-id length CDATA #IMPLIED>

<!-- Generators generate unique identifiers. The class attribute specifies a Java class
implementing an id generation algorithm. -->

<!ELEMENT generator (param*)>
<!ATTLIST generator class CDATA #REQUIRED>
<!ELEMENT param (#PCDATA)>
<!ATTLIST param name CDATA #REQUIRED>

<!-- The column element is an alternative to column attributes and required for
mapping associations to classes with composite ids. -->

<!ELEMENT column EMPTY>
<!ATTLIST column name CDATA #REQUIRED>
<!ATTLIST column length CDATA #IMPLIED> <!-- default: 255 -->
<!ATTLIST column not-null (true|false) #IMPLIED> <!-- default: false (except for id properties) -->
<!ATTLIST column unique (true|false) #IMPLIED> <!-- default: false (except for id properties) -->
<!ATTLIST column unique-key CDATA #IMPLIED> <!-- default: no unique key -->
<!ATTLIST column sql-type CDATA #IMPLIED> <!-- override default column type for hibernate type -->
<!ATTLIST column index CDATA #IMPLIED>

<!-- The jcs-cache element enables caching of an entity class. -->
<!ELEMENT jcs-cache EMPTY>
<!ATTLIST jcs-cache usage (read-only|read-write|nonstrict-read-write) #REQUIRED>

<!-- The query element declares a named Hibernate query string -->

<!ELEMENT query (#PCDATA)>
<!ATTLIST query name CDATA #REQUIRED>

<!-- The meta element is used to assign meta-level attributes to a class or property.
Is currently used by codegenerator as a placeholder for values that is not directly
related to OR mappings.
-->

<!ELEMENT meta (#PCDATA)>
<!ATTLIST meta attribute CDATA #REQUIRED>
<!ATTLIST meta inherit (true|false) "true">

if you are running hibernate 3.0 libraries, it will do the same thing, since the DTDs for Hibernate 2.1/2.0 are not included.