jsondiscoverer

Class JsonSimpleDiscoverer

java.lang.Object

jsondiscoverer.JsonSimpleDiscoverer

public class JsonSimpleDiscoverer
extends java.lang.Object

This class is used to discover/refine metamodels (as EPackage elements) from JSON documents (i.e., json file).

Once created, a metamodel out of a JsonSource element can be discovered by calling the method discover(JsonSource).

To refine a metamodel, you have to call to refine(EPackage, JsonSource) giving the metamodel to refine and a new JsonSource.

This implementation does not depend on Xtext (since v0.1.0)

Author:

Javier Canovas (me@jlcanovas.es)

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	DEFAULT_NS_PREFIX Default prefix for the discovered metamodel
private static java.lang.String	DEFAULT_NS_URI Default NS URI for the discovered metamodel
(package private) java.util.HashMap<java.lang.String,org.eclipse.emf.ecore.EClass>	eClasses The set of metamodel classes discovered
private static java.util.logging.Logger	LOGGER Used to log all the activity

Constructor Summary

Constructors

Constructor and Description
JsonSimpleDiscoverer() Constructs a new JsonSimpleDiscoverer element

Method Summary

Modifier and Type	Method and Description
private org.eclipse.emf.ecore.EClass	createMetaclass(java.lang.String id, com.google.gson.JsonObject jsonObject) Creates a new metaclass form scratch.
private void	createStructuralFeature(java.lang.String pairId, com.google.gson.JsonElement value, int lowerBound, org.eclipse.emf.ecore.EClass eClass) Creates a new EStructuralFeature out from a pairId/Value
private java.lang.String	digestId(java.lang.String id) Generates a type identifier from a String (normally coming for the key value of JSON objects)
org.eclipse.emf.ecore.EPackage	discover(JsonSource source) Launches the metamodel discoverer from a JSON document.
private org.eclipse.emf.ecore.EClass	discoverMetaclass(java.lang.String id, com.google.gson.JsonObject jsonObject) Discover a metaclass for a JsonSource
private java.util.HashMap<java.lang.String,org.eclipse.emf.ecore.EClass>	geteClasses() Returns the set of metamodel classes discovered
private org.eclipse.emf.ecore.EClassifier	mapType(java.lang.String id, com.google.gson.JsonElement value) Maps JSON types into ECORE types
org.eclipse.emf.ecore.EPackage	refine(org.eclipse.emf.ecore.EPackage toRefine, JsonSource source) Refines an existing metamodel with new JSON definitions coming from a new JsonSource.
private org.eclipse.emf.ecore.EClass	refineMetaclass(org.eclipse.emf.ecore.EClass eClass, com.google.gson.JsonObject jsonObject) Refines the attributes and references of an existing EClass from a new JsonObject definition.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_NS_PREFIX

private static final java.lang.String DEFAULT_NS_PREFIX

Default prefix for the discovered metamodel

See Also:

Constant Field Values

DEFAULT_NS_URI

private static final java.lang.String DEFAULT_NS_URI

Default NS URI for the discovered metamodel

See Also:

Constant Field Values

LOGGER

private static final java.util.logging.Logger LOGGER

Used to log all the activity

eClasses

java.util.HashMap<java.lang.String,org.eclipse.emf.ecore.EClass> eClasses

The set of metamodel classes discovered

Constructor Detail

JsonSimpleDiscoverer

public JsonSimpleDiscoverer()

Constructs a new JsonSimpleDiscoverer element

Method Detail

discover

public org.eclipse.emf.ecore.EPackage discover(JsonSource source)

Launches the metamodel discoverer from a JSON document.

The method receives a JsonSource element, which includes the set of JSON documents to be considered.

The discovered metamodel is returned and also stored in the JsonSource received as param (calling AbstractJsonSource.setMetamodel(EPackage)).

Parameters:

source - The JsonSource including the JSON documents

Returns:

The metamodel (as EPackage)

refine

public org.eclipse.emf.ecore.EPackage refine(org.eclipse.emf.ecore.EPackage toRefine,
                                             JsonSource source)

Refines an existing metamodel with new JSON definitions coming from a new JsonSource.

Parameters:

toRefine - The existing EPackage to refine

source - The JsonSource including the JSON documents

Returns:

The metamodel (as EPackage)

discoverMetaclass

private org.eclipse.emf.ecore.EClass discoverMetaclass(java.lang.String id,
                                                       com.google.gson.JsonObject jsonObject)

Discover a metaclass for a JsonSource

Parameters:

id - Unique identifier for the JsonObject

jsonObject - the JsonObject

Returns:

Discovered EClass

createMetaclass

private org.eclipse.emf.ecore.EClass createMetaclass(java.lang.String id,
                                                     com.google.gson.JsonObject jsonObject)

Creates a new metaclass form scratch. Takes a JsonObject as input and an identifier.

Parameters:

id - Unique identifier of the JsonObject

jsonObject - The new JsonObject

Returns:

The create metaclass (as EClass)

refineMetaclass

private org.eclipse.emf.ecore.EClass refineMetaclass(org.eclipse.emf.ecore.EClass eClass,
                                                     com.google.gson.JsonObject jsonObject)

Refines the attributes and references of an existing EClass from a new JsonObject definition.

Parameters:

eClass - The existing EClass

jsonObject - The JsonObject to use as input to refine

Returns:

The refined class (as EClass)

createStructuralFeature

private void createStructuralFeature(java.lang.String pairId,
                                     com.google.gson.JsonElement value,
                                     int lowerBound,
                                     org.eclipse.emf.ecore.EClass eClass)

Creates a new EStructuralFeature out from a pairId/Value

Parameters:

pairId - Identifier of the feature

value - JsonElement including the value

lowerBound - The lover bound for the structural feature

eClass - EClass containing the feature

mapType

private org.eclipse.emf.ecore.EClassifier mapType(java.lang.String id,
                                                  com.google.gson.JsonElement value)

Maps JSON types into ECORE types

Parameters:

id - Identifier of the feature (to infer the name of the type if non-primitive)

value - JsonElement including the value

Returns:

The mapped type (as EClassifier

digestId

private java.lang.String digestId(java.lang.String id)

Generates a type identifier from a String (normally coming for the key value of JSON objects)

Parameters:

id - String to digest

Returns:

The digested identifier

geteClasses

private java.util.HashMap<java.lang.String,org.eclipse.emf.ecore.EClass> geteClasses()

Returns the set of metamodel classes discovered

Returns:

List of EClass elements