Xpand 2.2

General

Bugfixes

Xpand 2.1

General

Version 2.1 is a maintenance release with a small number of bugfixes.

New Feature: Builder Exclusion Patterns

On large projects Xpand's builder may consume much time when saving resources. There was the demand to specify patterns of resources that are explicitly excluded from the build. A preference page has been added which allows the specification of the exclusion patterns. Further, the existing preference pages have been refactored.

Bugfixes

Xpand 2.0

General

Version 2.0 is the first major release since Xpand's initial transition from former openArchitectureWare. Over the time, Xpand's codebase evolved with solution of numerous issues, while strong backward API compatibility was kept. Although this version is a major version increment, it is mainly a maintenance release. But the breaking API changes made it necessary to declare it as such. Though the release is not strictly backward compatible, large portions of the code are still backward compatible. See below breaking API changes for reference.

Release Engineering

Target Platform

While we do our best to keep Xpand backward compatible to Eclipse Galileo (3.5), we cannot grant this compatibility to 100%. Xpand is built against Eclipse Juno (3.8). This is mainly caused by other frameworks Xpand is built against.

EMF Compare 2.1 - Used by Xpand Incremental Feature

MDT UML2 4.0 - Used by Xpand UML2 Typesystem Adapter

CDT 5.4 - Used by Xpand CDT Support Feature

Software User Agreement & License Update

The Eclipse Software User Agreement (SUA) contained a broken link, which made it necessary for all projects participating in the Eclipse Luna Release Train to update distributed files. See 431255, 432806 for details. Additionally Xpand's license was upgraded to the current 2014 version.

API Changes

Class org.eclipse.internal.xtend.util.ProfileCollector removed. It was used by Xpand's MWE components (Generator, CheckComponent, XtendComponent).

org.eclipse.internal.xtend.expression.ast.Identifier: toValue() was removed and replaced by toString().

Other Bugfixes

Version 1.4.0

General

Changes

API Changes

The API is kept backwards compatible. API changes are regarding new API or opened API.

The main workflow components Generator, XtendComponent and CheckComponent have been refactored to allow easier customization. State accessed by the main methods checkConfigurationInternal() and invokeInternal2() is reachable also from subclasses now by either protected fields or accessor methods. (406653).

The CDT support plugin org.eclipse.xpand.support.cdt is now build against CDT 5.4. There was usage of internal API of CDT 5.2, which was made public API with CDT 5.3. (406300, 390087)

Deprecations

Some methods and fields have been marked deprecated since they are planned for removal for 2.0. Affected classes are:

org.eclipse.xpand2.Generator

org.eclipse.xtend.XtendComponent

Bug Fixes

Performance related

When dependent resources are not existing, the resource caching in the UI does not work. This leads to performance downgrade during the analysis phase in the case that projects have this consistency error. The bug was introduced with release 1.3.0. (405165)

UI / Build

Only the first Jar of included resources are recognized for Content Assist (407934)

Runtime

During the build ClassCastExceptions were thrown when EMF classes have properties with array types. (406765)

Version 1.3.0

General

Changes

Performance and Memory Optimization

Xpand is used in large-scale projects, where overall performance is crucial. For the Kepler release Xpand has been intensively profiled to identify performance hot spots. Performance is meant in both execution performance as well as memory usage. Often the optimization on the one side reduces the performance on the other side: accelerating execution performance often uses caching, which increases memory usage, and vice-versa, reducing memory consumption requires more processing time. It has been taken into account that the performance gain pays off the downside. Sometimes performance could be improved in both ways, e.g. when garbage collection is performed less when unneccessary memory allocation is avoided, this also is positive for the execution performance.

Parser

The ANTLR based parser grammars have been refactored to perform better. Adding the location information was performed by subclass of the parser, which was now removed. The respective code has been inlined into the parsers.

AST

The AST classes (*.internal.*.ast.*) usually maintain lists or arrays of other AST elements. When these collections are empty, the instance field will be assigned to a constant empty array or collection. This avoids the unneccessary instantiation and references to empty collections.

Class Identifier, which usually makes the largest part of the AST elements, has been refactored. The strings that make up identifiers are separated into segments, which are hold by the newly introduced datastructure QualifiedName. String segments are interned in a weak cache, as well as QualifiedName instances. It is assured that only one instance per string or QualifiedName will exist. The weak cache allows instances to be garbage collected once they are not referenced.

Typesystem

The BuiltInMetaModel remembered cache misses for any queried type. This caused its cache map to grow and perform less. The BuiltInMetaModel will cache only type mappings for which it is responsible.

The usage of regular expressions for matching type names have been replaced by a faster implementation. (401144)

Builder

Xpand's builder performs now faster. Xpand searches the classpath for resources when queried by name. Therefore also jar archives are also searched. With Xpand 1.3 a blacklist is maintained to know which jar archives can be ignored in subsequent searches.

The feedback of the builder has been also improved. During a build, the progress monitor will now report detailed feedback on the current processing step and progress.

UML Support

Build

Sources for some plugins (e.g. org.eclipse.xtend.util.stdlib) were missing in the SDK (322980)

Tests for XSD Typesystem have been integrated into the build

Miscellaneous

«ENDREM-»: Xpand did not support the newline suppressing operator "-" for the ENDREM tag. Parser, Content Assist and Syntax Coloring have been fixed. (322394)

Templates with same file name: In the syntax analysis an error was shown, when two templates have the same file name, but different definitions within. The template that invokes one of these definitions with «EXPAND» might have an error marker ("Couldn't find definition..."). (400105)

Extensions from projects in development workspace: When extensions are used from plugin projects in a runtime test environment, the classpath folders from the plugins in development workspace are linked folders that contribute to the plugin classpath in the test environment. This is a quite typical scenario when developing and testing Xpand plugins. Using extensions from these plugin projects failed with exceptions and required to use a deployed version of the plugin, or importing these projects into the test workspace. (338695)

XMLBeautifier: The XMLBeautifier escaped newline characters with &#xD; on Windows when using Mixed Content. The beautifier has been extended to configure the desired newline format (SYSTEM, UNIX, WINDOWS). For older Xpand versions it is possible to work around the issue by configuration. (356576, 400672)

Version 1.2.1 (Juno)

General

Xpand 1.2.1 is a maintnance release and was released with Eclipse Juno.

Changes

Version 1.0.0 (Helios)

General

Changes

Incremental Generation

Xpand is now shipped with an optional incremental generation facility. This works very similar to the incremental Java compiler in Eclipse. It detects which parts of a model have changed since the last generation process. It then determines which files need to be generated due to that change and which are unaffected by it. Only the former are the regenerated, while the latter remain untouched.

Big models benefit from this feature. The generation of models with 1000 elements takes 50% of the time without incremental generation.

Backend

In large projects, generator speed is an issue, and the backend is designed with performance in mind. This requirement is what actually sparked its development in the first place. For performance and/or obfuscation reasons, the backend will serve as a basis for compilation into Java classes.

The design was driven by the following forces:

Performance

Compiler

Language independence

Independent of parse tree

Language interoperability

Reuse of Tooling

Profiler

Xpand provides profiler facilities by defining a profiling component. An example workflow using the profiler is shipped with the generator sample project (generatorWithProfiler.mwe).

Editor

A lot of enhancements are done for the Xpand editors.

The navigation of the Xpand editors is improved by more specific navigation proposals

Extension imports are now hyperlinks to the extension files

The Xpand project wizard allows a more detailed project configuration

A lot of other enchantments like markers for missing/not existing metamodels

Further improvements

ONFILECLOSE: The ONFILECLOSE keyword is added to the EXPAND statement and allows a deferred evaluation of the EXPAND statement. The evaluation of the EXPAND statement is deferred until the FILE statement is closed.

Java extensions: Since Xpand 0.8.0 non-static Java method can be called from Xtend.

Version 0.7.0 (Galileo)

General

The 0.7.0 version of the Xpand component from M2T is the first official Eclipse release of it. Xpand is a statically typed template language, featuring polymorphic dispatch, extensions and an open pluggable type system. It comes with Eclipse-based IDE support.

Xpand has previously been a part of openArchitectureWare and is used in many big projects and also shipped with some commercial products.

Changes

Performance

For the 0.7.0 release, the team has done some major performance improvements. Not only the runtime is up to 60% faster but due to aggressive caching we were able to improve the performance of the static analysis in the IDE about 400%.

IDE features

As this is the first release at Eclipse, some of the UI-features are outlined here.

File decorations

When you open Eclipse and import a project into the workspace you can see several file decorating images.

There are specific images for

Xpand2 templates (.xpt extension)

Extension files (.ext extension)

Check constraints (.chk extension)

Editors

When you double-click on one of the above mentioned file types, special editors will open that provide appropriate syntax coloring. Syntax coloring

Here are examples for the Xpand editor:

for the Extensions editor:

and for Check editor:

Code completion

The Editors provide extensive code completion support by pressing Ctrl + Space similar to what is known from the Java editor. Available types, properties, and operation, as well as extensions from .ext files will be found. The Xpand editor provides additionally support for the Xpand language statements. Xpand tag delimiter creation support.

In the Xpand editor there is an additional keystroke available to create the opening and closing tag brackets, the guillemets ("«" and "»").