com.dslplatform.client

Interface CrudProxy

public interface CrudProxy

Proxy service to remote CRUD REST-like API. Single aggregate root instance can be used. New object instance will be returned when doing modifications. Use standard proxy if a response is not required from the server.

It is preferred to use domain patterns instead of this proxy service.

Method Summary

Modifier and Type	Method and Description
<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate>	create(TAggregate aggregate) Creates a new aggregate root on the remote server.
<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate>	delete(java.lang.Class<TAggregate> manifest, java.lang.String uri) Deletes an existing aggregate root from the remote server.
<T extends Identifiable> java.util.concurrent.Future<T>	read(java.lang.Class<T> manifest, java.lang.String uri) Gets a domain object from the remote server using provided identity.
<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate>	update(TAggregate aggregate) Modifies an existing aggregate root on the remote server.

Method Detail

read

<T extends Identifiable> java.util.concurrent.Future<T> read(java.lang.Class<T> manifest,
                                                             java.lang.String uri)

Gets a domain object from the remote server using provided identity. If a domain object is not found an exception will be thrown.

Type Parameters:

T - identifiable domain type

Parameters:

manifest - domain object class (for deserialization)

uri - domain object identity

Returns:

future with the found domain object

create

<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate> create(TAggregate aggregate)

Creates a new aggregate root on the remote server. Created object will be returned with a new identity and all calculated properties evaluated.

Type Parameters:

TAggregate - aggregate root type

Parameters:

aggregate - new aggregate root

Returns:

future with the aggregate root with a new identity

update

<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate> update(TAggregate aggregate)

Modifies an existing aggregate root on the remote server. Aggregate root will be saved and all calculated properties evaluated.

Type Parameters:

TAggregate - aggregate root type

Parameters:

aggregate - modified aggregate root

Returns:

future with the aggregate root with updated attributes

delete

<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate> delete(java.lang.Class<TAggregate> manifest,
                                                                                  java.lang.String uri)

Deletes an existing aggregate root from the remote server. If possible, aggregate root will be deleted and its instance returned.

Type Parameters:

TAggregate - aggregate root type

Parameters:

manifest - aggregate root class (for deserialization)

uri - aggregate root identity

Returns:

future with the deleted aggregate root instance