jinx 2.1.1

data/examples/family/lib/family.rb

@@ -0,0 +1,15 @@
+# Add the Java jar file to the Java path.
+require File.dirname(__FILE__) + '/../ext/bin/family.jar'
+
+# The Jinx Model example application domain module.
+module Family
+  include Jinx::Resource
+  
+  extend Jinx::Importer
+  
+  # The Java package name.
+  packages 'family'
+  
+  # The JRuby mix-ins are in the model subdirectory.
+  definitions File.dirname(__FILE__) + '/family'
+end

data/examples/family/lib/family/address.rb

@@ -0,0 +1,6 @@
+module Family
+  class Address
+    # The postal code is aliased as zip.
+    property :postal_code, :alias => :zip
+  end
+end

data/examples/family/lib/family/domain_object.rb

@@ -0,0 +1,6 @@
+module Family
+  class DomainObject
+    # The identifier property is the primary key.
+    property :identifier, :primary_key
+  end
+end

data/examples/family/lib/family/household.rb

@@ -0,0 +1,6 @@
+module Family
+  class Household
+    # The household owns its address.
+    property :address, :dependent
+  end
+end

data/examples/family/lib/family/parent.rb

@@ -0,0 +1,16 @@
+module Family
+  class Parent
+    # The SSN is a secondary key
+    property :ssn, :secondary_key
+    
+    # A parent owns children.
+    property :children, :dependent
+    
+    # The spouse is an independent reference. The spouse is an idempotent inverse,
+    # i.e. parent = parent.spouse.spouse.
+    property :spouse, :inverse => :spouse
+    
+    # The household is an independent reference with inverse members.
+    property :household, :inverse => :members
+  end
+end

data/examples/family/lib/family/person.rb

@@ -0,0 +1,6 @@
+module Family
+  class Person
+    # The household is an independent reference with inverse members.
+    property :household, :inverse => :members
+  end
+end

data/examples/model/README.md

@@ -0,0 +1,25 @@
+Jinx Model Example
+===================
+
+This directory contains a generic Jinx usage example which exercises most of the meta-data possibilities.
+The associations are as follows:
+
+* Parent is-a Person
+
+* Child is-a Person
+
+* 1 Parent : N Children (bidirectonal dependent)
+
+* 1 Parent : 1 spouse Parent (bidirectonal independent)
+
+* 1 Person : 1 Dependent (unidirectonal dependent)
+
+* 1 Independent : N People  (bidirectional independent)
+
+* M Children : N friend Children  (bidirectional self-referential typed independent)
+
+* M Independents : N other Independents  (bidirectional self-referential untyped independent)
+
+* 1-2 Parents : N Children (bidirectonal dependent)
+
+Every object has an identifier and a name. Child has all supported primitive property types.

data/examples/model/ext/build.xml

@@ -0,0 +1,35 @@
+<?xml version ="1.0"?>
+
+<project name="import Jinx test fixture" default="jar">
+
+  <!--build locations -->
+  <property name="base.dir" value="." />
+  <property name="source.dir" value="src" />
+  <property name="target.dir" value="classes" />
+  <property name="bin.dir" value="bin" />
+
+  <target name="init">
+    <tstamp />
+    <mkdir dir="${target.dir}" />
+    <mkdir dir="${bin.dir}" />
+  </target>
+
+  <!-- Compile all files in the source directory -->
+  <target name="compile" depends="init">
+    <javac destdir="${target.dir}" includes="**/*.*" includeAntRuntime="false">
+      <src path="${source.dir}" />
+      <compilerarg value="-Xlint:unchecked"/>
+    </javac>
+  </target>
+
+  <target name="jar" depends="compile">
+    <jar destfile="${bin.dir}/model.jar" basedir="${target.dir}" includes="**/*.*" />
+  </target>
+
+  <!-- Remove build directories -->
+  <target name="clean">
+    <delete dir="${bin.dir}" />
+    <delete dir="${target.dir}" />
+  </target>
+
+</project>

data/examples/model/ext/src/domain/Child.java

@@ -0,0 +1,192 @@
+package domain;
+
+import java.util.Collection;
+import java.util.ArrayList;
+
+public class Child extends DomainObject implements Person
+{
+    /**
+     * A string property.
+     */
+    private String name;
+
+    /**
+     * A boolean property.
+     */
+    private Jinx::Boolean flag;
+
+    /**
+     * An integer property.
+     */
+    private Integer cardinal;
+
+    /**
+     * A decimal property.
+     */
+    private Double decimal;
+
+    /**
+     * This child's parent.
+     * <p>
+     * This property exercises a reference from a dependent to its owner.
+     * </p>
+     */
+    private Parent parent;
+
+    /**
+     * This child's siblings.
+     * <p>
+     * This property exercises a 1:M self-reference.
+     * </p>
+     */
+    private Collection<Child> friends;
+
+    /**
+     * This child's independent reference.
+     * <p>
+     * This property exercises a reference to an independent object.
+     * </p>
+     */
+    private Independent indy;
+
+    /**
+     * This child's uni-directional dependent reference.
+     * <p>
+     * This property exercises a reference to a uni-directional dependent object.
+     * </p>
+     */
+    private Dependent dependent;
+
+    public Child()
+    {
+      friends = new ArrayList<Child>();
+    }
+
+    /**
+     * @return the name
+     */
+    public String getName()
+    {
+        return name;
+    }
+
+    /**
+     * @param name the name to set
+     */
+    public void setName(String name)
+    {
+        this.name = name;
+    }
+    
+    /**
+     * @return the flag
+     */
+    public Jinx::Boolean getFlag()
+    {
+        return flag;
+    }
+
+    /**
+     * @param flag the flag to set
+     */
+    public void setFlag(Jinx::Boolean flag)
+    {
+        this.flag = flag;
+    }
+
+    /**
+     * @return the decimal
+     */
+    public Double getDecimal()
+    {
+        return decimal;
+    }
+
+    /**
+     * @param decimal the decimal to set
+     */
+    public void setDecimal(Double decimal)
+    {
+        this.decimal = decimal;
+    }
+
+    /**
+     * @return the cardinal
+     */
+    public Integer getCardinal()
+    {
+        return cardinal;
+    }
+
+    /**
+     * @param cardinal the cardinal to set
+     */
+    public void setCardinal(Integer cardinal)
+    {
+        this.cardinal = cardinal;
+    }
+
+    /**
+     * @return the parent
+     */
+    public Parent getParent()
+    {
+        return parent;
+    }
+
+    /**
+     * @param parent the parent to set
+     */
+    public void setParent(Parent parent)
+    {
+        this.parent = parent;
+    }
+
+    /**
+     * @return the child independent reference
+     */
+    public Independent getIndy()
+    {
+        return indy;
+    }
+
+    /**
+     * @param indy the child independent reference to set
+     */
+    public void setIndy(Independent indy)
+    {
+        this.indy = indy;
+    }
+
+    /**
+     * @return the friends
+     */
+    public Collection<Child> getFriends()
+    {
+        return friends;
+    }
+
+    /**
+     * @param friends the friends to set
+     */
+    public void setFriends(Collection<Child> friends)
+    {
+        this.friends = friends;
+    }    
+    
+    /**
+     * @return the dependent
+     */
+    public Dependent getDependent()
+    {
+        return dependent;
+    }
+
+    /**
+     * @param dependent the dependent to set
+     */
+    public void setDependent(Dependent dependent)
+    {
+        this.dependent = dependent;
+    }
+}

data/examples/model/ext/src/domain/Dependent.java

@@ -0,0 +1,29 @@
+package domain;
+
+public class Dependent extends DomainObject
+{
+    /**
+     * A string property.
+     */
+    private String name;
+
+    public Dependent()
+    {
+    }
+
+    /**
+     * @return the name
+     */
+    public String getName()
+    {
+        return name;
+    }
+
+    /**
+     * @param name the name to set
+     */
+    public void setName(String name)
+    {
+        this.name = name;
+    }
+}

data/examples/model/ext/src/domain/DomainObject.java

@@ -0,0 +1,26 @@
+package domain;
+
+public abstract class DomainObject
+{
+    private Long identifier;
+
+    public DomainObject()
+    {
+    }
+
+    /**
+     * @return the database identifier
+     */
+    public Long getIdentifier()
+    {
+        return identifier;
+    }
+
+    /**
+     * @param id the id to set
+     */
+    public void setIdentifier(Long id)
+    {
+        this.identifier = id;
+    }
+}

data/examples/model/ext/src/domain/Independent.java

@@ -0,0 +1,83 @@
+package domain;
+
+import java.util.Collection;
+import java.util.ArrayList;
+import java.util.HashSet;
+
+public class Independent extends DomainObject
+{
+    /**
+     * A string property.
+     */
+    private String name;
+
+    /**
+     * The people which reference this object.
+     * <p>
+     * This property exercises a heterogenous 1:M reference.
+     * </p>
+     */
+    private Collection<Person> people;
+
+    /**
+     * The other independents.
+     * <p>
+     * This property exercises an unparameterized M:N independent reference.
+     * </p>
+     */
+    private Collection others;
+
+    public Independent()
+    {
+        people = new HashSet<Person>();
+        others = new ArrayList();
+    }
+
+    /**
+     * @return the name
+     */
+    public String getName()
+    {
+        return name;
+    }
+
+    /**
+     * @param name the name to set
+     */
+    public void setName(String name)
+    {
+        this.name = name;
+    }
+
+    /**
+     * @return the others
+     */
+    public Collection<Person> getPeople()
+    {
+        return people;
+    }
+
+    /**
+     * @param others the others to set
+     */
+    public void setPeople(Collection<Person> people)
+    {
+        this.people = people;
+    }
+
+    /**
+     * @return the others
+     */
+    public Collection getOthers()
+    {
+        return others;
+    }
+
+    /**
+     * @param others the others to set
+     */
+    public void setOthers(Collection others)
+    {
+        this.others = others;
+    }
+}