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 response is not required from the server.

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

Method Summary

Methods

Modifier and Type	Method and Description
<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate>	create(TAggregate aggregate) Create 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) Delete 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) Get domain object from remote server using provided identity.
<TAggregate extends AggregateRoot> java.util.concurrent.Future<TAggregate>	update(TAggregate aggregate) Modify 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)

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

Parameters:

manifest - domain object type

uri - domain object identity

Returns:

future to found domain object

create

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

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

Parameters:

aggregate - new aggregate root

Returns:

future to aggregate root with new identity

update

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

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

Parameters:

aggregate - modified aggregate root

Returns:

future to aggregate root with updated attributes

delete

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

Delete existing aggregate root from the remote server. If possible, aggregate root will be deleted and it's instance will be provided.

Parameters:

manifest - aggregate root type

uri - aggregate root identity

Returns:

future to deleted aggregate root instance