Difference between revisions of "Texo/Download and Install"

From Eclipsepedia

Jump to: navigation, search
(Maven)
(Maven)
(10 intermediate revisions by one user not shown)
Line 22: Line 22:
  
 
To use the runtime layer of Texo in a web container you need the following jar files:
 
To use the runtime layer of Texo in a web container you need the following jar files:
* '''org.eclipse.emf.texo'''  
+
* '''org.eclipse.emf.texo''': Texo core
 
* '''org.eclipse.emf.texo.server''': for server side logic, entitymanager handling etc.
 
* '''org.eclipse.emf.texo.server''': for server side logic, entitymanager handling etc.
 
* '''org.eclipse.emf.texo.json''': for json serialization and json web service support
 
* '''org.eclipse.emf.texo.json''': for json serialization and json web service support
 
* '''org.eclipse.emf.texo.xml''': for xml and xmi serialization for xml/json web service support
 
* '''org.eclipse.emf.texo.xml''': for xml and xmi serialization for xml/json web service support
* '''org.eclipse.emf.texo.datagenerator''': for generating test data
 
  
The Texo runtime JAR and the generated runtime classes (*ModelFactory, *ModelPackage) depend on 3 (EMF) jar-files which are available through maven:
+
The Texo runtime JAR and the generated runtime classes (*ModelFactory, *ModelPackage) depend on 3 (EMF) jar-files:
 
* '''org.eclipse.emf.common'''
 
* '''org.eclipse.emf.common'''
 
* '''org.eclipse.emf.ecore'''
 
* '''org.eclipse.emf.ecore'''
 
* '''org.eclipse.emf.ecore.xmi'''
 
* '''org.eclipse.emf.ecore.xmi'''
  
These jar files are available through maven (for example version 2.8.0-v20120911-0500).
+
These jar files are available through maven (for example version 2.8.0-v20120911-0500), or can be found in the plugins directory of your Eclipse installation.
  
You can also configure Texo to [[Texo/Code_Generation_Patterns#Only_Generate_Entities_-_No_EMF_dependencies | only generate Entities, no EMF dependencies]].
+
Note: you can also configure Texo to [[Texo/Code_Generation_Patterns#Only_Generate_Entities_-_No_EMF_dependencies | only generate Entities, without EMF dependencies]]. In this case there is no dependency on EMF.
  
For '''JSON''' web service support you also need to obtain org.json jar file. These can be downloaded from the maven central repository, the internet, or try [http://www.eclipse.org/downloads/download.php?r=1&file=/tools/orbit/downloads/drops/R20110523182458/repository/plugins/org.json_1.0.0.v201011060100.jar this] location.
+
For '''JSON''' web service support you also need to obtain org.json jar file. These can be downloaded from the maven central repository, or try [http://www.eclipse.org/downloads/download.php?r=1&file=/tools/orbit/downloads/drops/R20110523182458/repository/plugins/org.json_1.0.0.v201011060100.jar this] location.
  
 
=== Maven ===
 
=== Maven ===
  
Texo jars (and the dependency on EMF) are also available in the [http://search.maven.org/#search%7Cga%7C1%7Corg.eclipse.emf.texo maven central repository} and in the [https://oss.sonatype.org/content/repositories/snapshots/org/eclipse/emf/ sonatype snapshot repository].  
+
Texo jars (and their EMF dependencies) are also available in the [http://search.maven.org/#search%7Cga%7C1%7Corg.eclipse.emf.texo maven central repository] and in the [https://oss.sonatype.org/content/repositories/snapshots/org/eclipse/emf/ sonatype snapshot repository].  
  
The EMF jar files are published within the same group id. For version numbers check the [http://search.maven.org/#search%7Cga%7C1%7Corg.eclipse.emf.texo central] and [https://oss.sonatype.org/content/repositories/snapshots/org/eclipse/emf/ sonatype-snapshot] repositories. Texo will work fine with older versions of EMF, but if you can use the latest EMF versions available in maven central.
+
Here is an example on how to make use of Texo snapshots available through sonatype:
 +
<source lang="xml">
 +
<repositories>
 +
  <repository>
 +
    <id>sonatype-oss-public</id>
 +
    <url>https://oss.sonatype.org/content/groups/public/</url>
 +
    <releases>
 +
      <enabled>true</enabled>
 +
    </releases>
 +
    <snapshots>
 +
      <enabled>true</enabled>
 +
    </snapshots>
 +
  </repository>
 +
</repositories>
 +
</source>
 +
 
 +
The EMF jar files are published within the same group id as Texo: [http://search.maven.org/#search%7Cga%7C1%7Cg%3A%22org.eclipse.emf%22 org.eclipse.emf]. Texo will work fine with older versions of EMF (from 2.5.0 onwards), but if you can, use the latest EMF versions available in maven central.
 +
 
 +
When using maven in your project it makes sense to check this troubleshooting tip:
 +
* [[Texo/Troubleshooting#Using_maven.2C_getting_NPE_or_ecore_file_not_found_exception_at_runtime|maven and ecore file not found]]
  
 
'''Note: the Texo pom files currently do not explicitly define dependencies to the EMF and json libraries. This means that you manually need to define the dependency to these libraries in your own pom. This will be re-solved/fine-tuned in later versions.'''
 
'''Note: the Texo pom files currently do not explicitly define dependencies to the EMF and json libraries. This means that you manually need to define the dependency to these libraries in your own pom. This will be re-solved/fine-tuned in later versions.'''
Line 49: Line 67:
 
=== Download Texo jar files ===
 
=== Download Texo jar files ===
  
The Texo jar files can also be downloaded through a browser from this page: http://download.eclipse.org/modeling/emft/texo/updates/interim
+
The Texo jar files can also be downloaded directly from this page: http://download.eclipse.org/modeling/emft/texo/updates/interim
  
 
== Texo Example Project(s) ==
 
== Texo Example Project(s) ==

Revision as of 14:55, 15 December 2012

Contents


Texo provides both a development as well as a runtime solution. The development plugins can be downloaded and installed in Eclipse using the update manager. For runtime usage you can use maven or download directly. See further below for more information.

Development Environment: update manager

For Texo's development solutions you need to install Texo into Eclipse. This is done through an update manager. For runtime usage of Texo see the next section.

Texo is available through this update site:

The last successful nightly build is available through this update site:

After installing and restarting you can generate code from ecore/xsd models and refer to Texo plugins from plugin MANIFEST.MF files.

Runtime usage, web container

For runtime usage you have several options to download the Texo jar files and their dependencies.

Texo jar files and dependencies

To use the runtime layer of Texo in a web container you need the following jar files:

  • org.eclipse.emf.texo: Texo core
  • org.eclipse.emf.texo.server: for server side logic, entitymanager handling etc.
  • org.eclipse.emf.texo.json: for json serialization and json web service support
  • org.eclipse.emf.texo.xml: for xml and xmi serialization for xml/json web service support

The Texo runtime JAR and the generated runtime classes (*ModelFactory, *ModelPackage) depend on 3 (EMF) jar-files:

  • org.eclipse.emf.common
  • org.eclipse.emf.ecore
  • org.eclipse.emf.ecore.xmi

These jar files are available through maven (for example version 2.8.0-v20120911-0500), or can be found in the plugins directory of your Eclipse installation.

Note: you can also configure Texo to only generate Entities, without EMF dependencies. In this case there is no dependency on EMF.

For JSON web service support you also need to obtain org.json jar file. These can be downloaded from the maven central repository, or try this location.

Maven

Texo jars (and their EMF dependencies) are also available in the maven central repository and in the sonatype snapshot repository.

Here is an example on how to make use of Texo snapshots available through sonatype:

<repositories>
  <repository>
    <id>sonatype-oss-public</id>
    <url>https://oss.sonatype.org/content/groups/public/</url>
    <releases>
      <enabled>true</enabled>
    </releases>
    <snapshots>
      <enabled>true</enabled>
    </snapshots>
  </repository>
</repositories>

The EMF jar files are published within the same group id as Texo: org.eclipse.emf. Texo will work fine with older versions of EMF (from 2.5.0 onwards), but if you can, use the latest EMF versions available in maven central.

When using maven in your project it makes sense to check this troubleshooting tip:

Note: the Texo pom files currently do not explicitly define dependencies to the EMF and json libraries. This means that you manually need to define the dependency to these libraries in your own pom. This will be re-solved/fine-tuned in later versions.

Download Texo jar files

The Texo jar files can also be downloaded directly from this page: http://download.eclipse.org/modeling/emft/texo/updates/interim

Texo Example Project(s)

The Texo example projects are hosted in this git repository:

This video discusses the example project setup and demos JSON web service support.