Versionsinformationen GraphML Erweiterungspaket

GraphML 3.2 ist die aktuelle Version des yFiles XML Erweiterungspaketes.

Technische Voraussetzungen

Graphvisualisierungsbibliothek yFiles for Java 2.7 bzw. yFiles for Java 2.6 und Sun Microsystems J2SDK 1.4 oder höher zur Software Entwicklung.
Um die Dokumentation anzuschauen, wird Microsoft Internet Explorer 6.0 (oder höher) oder Mozilla Firefox 1.5 (oder höher) benötigt.

GraphML 3.2 - Änderungen zu Version 3.1 (englisch)

General

GraphML 3.2 is available in two different editions:

GraphML 3.2 for yFiles for Java 2.7 version series which is only compatible with yFiles for Java 2.7 version series.
This edition fixes compatibility issues with yFiles for Java 2.7, it does not support the following new features of yFiles for Java 2.7:
- Serialization and deserialization of style properties of GenericNodeRealizer and GenericEdgeRealizer.
- Serialization and deserialization of TableGroupNodeRealizer.
- Serialization and deserialization of custom node and edge label models.
Support for these features is provided by the integrated GraphML support present in yFiles for Java 2.7.
GraphML 3.2 for yFiles for Java 2.6 version series which is only compatible with yFiles for Java 2.6 version series.

New Features

New interfaces org.graphdrawing.graphml.reader.dom.DOMGraphMLParser.HandlerProvider and org.graphdrawing.graphml.writer.DirectGraphMLWriter.HandlerProvider allow for dynamic registration of DOMInputHandler and OutputHandler instances at runtime.
New interface Precedence allows for specifying a partial order of OutputHandlers when writing.

Bugfixes

Fixed possible NullPointerException in AttributeInputHandler when reading empty default tags.
DotnetGraphElementProvider: fixed incorrect handling of nested graphs.

Other Changes

DotnetGraphElementFactory: It is possible to specify a default node size for nodes without geometry information.

GraphML 3.1 - Änderungen zu Version 3.0.3 (englisch)

New Features

Full compatibility with yFiles for Java 2.6
DotnetGraphElementProvider: ports at the same location can optionally be merged to the same logical instance.
New interfaces ResourceDecoderProvider, ResourceEncoderProvider, and DefaultConverterProvider allow fine-tuning of shared resources like images.

Bugfixes

Fixed possible NullPointerException in DOMGraphMLParser.

Other Changes

Interface AttributeConstants: new constant TYPE_COMPLEX for compatibility with yFiles FLEX and yFiles.NET
DotnetGraphElementFactory: grouping-related DataProviders are not created automatically if they don't exist on the target graph already. Instead, this behavior is controlled by property setAutoCreateGroupingDPs.

GraphML 3.0.3 - Änderungen zu Version 3.0.2 (englisch)

Incompatible API Changes

Interface XmlWriter: new method setDTD to allow the specification of a PUBLIC ID for the DTD.

Bugfixes

Fixed poor rendering performance of inlined images for JRE >= 1.6.
Label model edge_opposite was not handled correctly.
XML namespace for core GraphML elements is determined automatically on parsing. This fixes problems with varying namespace declarations for these elements.
Fixed indentation problems for several XML implementations.
Made node order for output consistent in nested graphs.
Fixed broken XSL stylesheets for XMLXSLIOHandler.

GraphML 3.0.2 - Änderungen zu Version 3.0.1 (englisch)

New Features

Icons for labels are supported now.
Icons for source and target ports are supported now.

Incompatible API Changes

Class GraphicsSerializationToolkit: Several methods have been deprecated and superseded by context aware overloads.

Bugfixes

Fixed invalid attribute exception when ImageNodeRealizers with active alpha channel are used.
setReadEmbeddedResources: Value has been ignored for most input handlers. This has been fixed.

GraphML 3.0.1 - Änderungen zu Version 3.0 (englisch)

New Features

.NET compatibility classes don't depend on Graph2D anymore.
A custom .NET compatibility I/O handler has been added.
Several new callback methods have been added to GraphMLIOHandler for easier customization.

Incompatible API Changes

Interface XmlWriter: new methods writeAttribute and writeDocumentFragment.

Other Changes

Classes in yext.graphml.graph2D don't throw exceptions when used together with other y.base.Graph implementations than Graph2D.
Default RealizerSerializers can be retrieved through getFallbackRSM.
Added convenience method addNamespace.

Bugfixes

AttributeOutputHandler writes an empty element when null values are encountered.
Added workaround for wrong yFiles extension namespace that has been written by some GraphML releases.
Invisible line color for edges was not parsed correctly.
Attributes with same name, but different scopes are now handled correctly.

GraphML 3.0 - Änderungen zu Version 2.4.2 (englisch)

New Features

New interface XmlWriter for structured XML output.
Support for embedded resources, used in class ImageNodeRealizerSerializer.
Support for element ID persistence through interfaces IdAcceptor and IdProvider.
GraphMLIOHandler now supports instance specific registration of RealizerSerializers.
Support for .NET style layout information in package yext.graphml.compat.
Framework support for <port> elements.
Support for <graphml> and <port> scopes.
Fine grained error handling through interfaces GraphMLParseErrorHandler and GraphMLWriteErrorHandler, together with exception nesting in GraphMLParseException.
Classes GraphMLParseContext and GraphMLWriteContext implement new interface Lookup, which allows to carry arbitrary information through the (de)serialization process.
Much more namespace awareness.
Precedence for DOMInputHandler is now used for all scopes.
GraphMLIOHandler: new properties for the new features, overloads for read and write methods to read/write to different data sources/targets.
The schema definition has been updated to reflect the aforementioned changes and additions.

Incompatible API Changes

Class org.graphdrawing.graphml.writer.IndentPrintWriter has been removed and replaced by interface XmlWriter.
Interface OutputHandler and implementing classes:
- Methods getKeyAttributes, getDataAttributes replaced by printKeyAttributes and printDataAttributes, respectively.
- All method signatures have been changed to org.graphdrawing.graphml.writer.GraphMLWriteContext, org.graphdrawing.graphml.writer.XmlWriter and void return value.
Class AbstractOutputHandler: Changed signature of printDataOutput.
Interface XMLAttributesProvider: All getXXXAttributes methods replaced by corresponding printXXXAttributes methods.
Interface XMLAttributesParser: Added method parsePortAttributes.
Class GraphicsSerializationToolkit: All signatures that used org.graphdrawing.graphml.writer.IndentPrintWriter now use XmlWriter instead.
Interface GraphElementProvider:
- Indexed access to graph elements in methods getNodeObject(int), getEdgeObject(int), getHyperEdgeObject(int), getEndpoint(java.lang.Object, int) has been replaced by iterators getNodeObjects, getEdgeObjects, getHyperEdgeObjects, getEndpointObjects.
- New methods getSourcePort, getTargetPort, getPortObjects.
Interface GraphElementFactory: changed signature of createPort.
Classes DOMGraphMLParser and DirectGraphMLWriter: Multiple interface changes to adapt for other API changes.
Interfaces NodeRealizerSerializer and EdgeRealizerSerializer and implementing classes: Signature changes for write and writeAttributes, new methods canHandle, canHandle, createRealizerInstance, getNamespaceURI, getNamespacePrefix. The abstract base classes AbstractNodeRealizerSerializer and AbstractEdgeRealizerSerializer provide backward compatible implementations for these methods.
Classes AbstractNodeRealizerSerializer and AbstractEdgeRealizerSerializer: methods setWriteSelectionStateEnabled(boolean) and isWriteSelectionStateEnabled(boolean) have been moved to class GraphMLIOHandler.
Class GraphMLParseContext is now abstract.
Class PostprocessorOutputHandler: Method getPostprocessorsString(y.base.Graph) has been removed, instead call printDataOutput directly.
Class XMLXSLIOHandler: changed all y.io.IOHandler method parameters to GraphMLIOHandler.

Deprecated Classes and Methods

Class GeomGraphMLIOHandler has been deprecated.
Adding a scoped DOMInputHandler with addInputHandler has been deprecated.
Class GraphMLIOHandler: Static methods addEdgeRealizerSerializer and addNodeRealizerSerializer have been deprecated, use class RealizerSerializerManager instead for instance specific registration. This also applies to classes ReadNodeRealizerHandler, ReadEdgeRealizerHandler, WriteNodeRealizerHandler and WriteEdgeRealizerHandler.

Other Changes

Class DOMGraphMLParser as well as all RealizerSerializer implementations implement strict namespace handling. Therefore, documents with incorrect namespace declarations for the core GraphML namespace and/or the yFiles extensions won't be parsed correctly.
Adding a scoped DOMInputHandler with addInputHandler has been deprecated and won't use the scope at all. Scope filtering must now be implemented exclusively through acceptKey. The same applies to getInputHandlers which has been replaced by unscoped method getInputHandlers.
By default, class ImageNodeRealizerSerializer reads the embedded image resource if both resource and image URL exist. This behavior can be changed with setReadEmbeddedResources.
By default, ReadNodeRealizerHandler and ReadEdgeRealizerHandler always parse realizer geometry, even if no RealizerSerializer for the XML node could be found. This can be changed by supplying an own implementation of GraphMLParseErrorHandler to GraphMLIOHandler.
By default, GenericNodeRealizerSerializer and GenericEdgeRealizerSerializer use a default configuration if no matching configuration could be found. This can be changed by supplying an own implementation of GraphMLParseErrorHandler to GraphMLIOHandler.
DOMGraphMLParser correctly handles multiple <data> tags with identical keys for the same attribute owner.

Bugfixes

Bugfix for wrong interedges in nested graphs.
Schema fixes for new attributes in yFiles 2.5.
Updated included schemata to the newest version from http://graphml.graphdrawing.org.