StateModelingDocs.java

package org.qi4j.demo.intro;

import org.qi4j.api.association.Association;
import org.qi4j.api.association.ManyAssociation;
import org.qi4j.api.common.Optional;
import org.qi4j.api.common.UseDefaults;
import org.qi4j.api.entity.Aggregated;
import org.qi4j.api.entity.EntityBuilder;
import org.qi4j.api.entity.EntityComposite;
import org.qi4j.api.injection.scope.This;
import org.qi4j.api.mixin.Mixins;
import org.qi4j.api.property.Property;
import org.qi4j.api.unitofwork.UnitOfWork;
import org.qi4j.api.value.ValueComposite;

public class StateModelingDocs
{

// START SNIPPET: intro1
    interface PersonEntity
            extends EntityComposite
    {
        Property<String> givenName();
        Property<String> surName();
    }

// END SNIPPET: intro1




    static class Roles {

// START SNIPPET: roles
        interface Nameable
        {
            @UseDefaults Property<String> givenName();
            @UseDefaults @Optional Property<String> surName();
        }

        interface PersonEntity
                extends Nameable, EntityComposite
        {}
// END SNIPPET: roles
    }

    static class Values {

// START SNIPPET: values
        interface NameValue
                extends ValueComposite
        {
            @UseDefaults Property<String> givenName();
            @UseDefaults @Optional Property<String> surName();
        }

        interface Nameable
        {
            Property<NameValue> name();
        }
// END SNIPPET: values


// START SNIPPET: private
        @Mixins(ListablePersonMixin.class)
        interface PersonEntity
                extends Listable, EntityComposite {}

        interface PersonState
                extends Nameable {}

        public class ListablePersonMixin
                implements Listable
        {
            @This PersonState person;

            @Override
            public String listName()
            {
                String fullName = person.name().get().givenName().get();
                String sn = person.name().get().surName().get();
                if (sn != null) fullName += " "+sn;
                return fullName;
            }
        }

        interface Listable
        {
            public String listName();
        }
// END SNIPPET: private

    }


    static class More {
// START SNIPPET: more
        interface PersonEntity
                extends EntityComposite
        {
            Association<PersonEntity> father();
            @Optional Association<PersonEntity> spouse();
            ManyAssociation<PersonEntity> children();
            @Aggregated ManyAssociation<BookNoteEntity> favouriteBooks();
        }

        interface BookNoteEntity
                extends EntityComposite
        {
            Property<String> note();
            Association<BookEntity> book();
        }

// END SNIPPET: more
        interface BookEntity
                extends EntityComposite
        {}
    }

}