Morphia

Morphia is an Object/Document mapper. It provides annotation-based POJO mapping, and fluent query/update APIs. SeedStack MongoDb add-on provides a module for Morphia.

Dependency

<dependency>
    <groupId>org.seedstack.addons.mongodb</groupId>
    <artifactId>mongodb-morphia</artifactId>
    <version>3.1.3</version>
</dependency>

dependencies {
    compile("org.seedstack.addons.mongodb:mongodb-morphia:3.1.3")
}

Configuration

To configure Morphia, just specify the synchronous client and which one of its database to use for a mapping a specific class. This is done with SeedStack class configuration:

mongoDb:
  clients:
    clients1:
      uri: ...
      databases: db1
classes:
  org:
    myorg:
      myapp:
        domain:
          model:
            mongoDbClient: client1
            mongoDbDatabase: db1

The configuration above will use the MongoDb client client1 and its database db1 for mapping classes in the org.myorg.myapp.domain.model package and its subpackages.

Basic usage

Mapping

Mapping is done with annotations:

@Entity
public class User {
	@Id
	private long id;
	private String firstName;
	private String lastName;
    @Embedded    
    private Address address;
    
	// ...
}

@Embedded
public class Address {
	private String country;
	private String zipCode;
	private String city;
	private String street;
	private Integer number;
	
	// ...
}

Datastore

A Morphia Datastore can be injected by qualifying the injection with the @MorphiaDatastore annotation with the client and the database name as parameters::

public class SomeClass {
	@Inject
	@MorphiaDatastore(clientName = "client1",dbName="db1")
	private Datastore datastore; 
	
	@Test
	public void someMethod(){
		User user = new User();
		Key<User> keyUser = datastore.save(user);
	}
}

Business framework usage

The Morphia add-on also provides repositories for the Business Framework.

Base for custom repositories

A base repository is provided for extension:

public interface SomeAggregateRepository extends Repository<SomeAggregate, String> {
    // ...
}

public class SomeAggregateMongoRepository extends BaseMorphiaRepository<SomeAggregate, String> 
                                          implements SomeAggregateRepository {
    //...
}

This can then be injected as usual:

public class SomeClass {
    @Inject
    private SomeAggregateRepository someAggregateRepository;
}

Default repositories

If you don’t need repository custom methods, default repositories for all aggregates are automatically registered and can be injected using Repository interface with the @Morphia qualifier:

public class SomeClass {
	@Inject
	@Morphia
	private Repository<SomeAggregate, String> someAggregateRepository;
}