Package com.atlassian.confluence.rest.client.impl

Class RemoteRelationServiceImpl

java.lang.Object

com.atlassian.confluence.rest.client.AbstractRemoteService<RelationService>

com.atlassian.confluence.rest.client.impl.RemoteRelationServiceImpl

All Implemented Interfaces:

RemoteRelationService

public class RemoteRelationServiceImpl
extends AbstractRemoteService<RelationService>
implements RemoteRelationService

RelationService implementation that communicates with Confluence remotely using the Confluence REST API.

Field Summary

Fields inherited from class com.atlassian.confluence.rest.client.AbstractRemoteService

provider

Constructor Summary

Constructors

Constructor	Description
RemoteRelationServiceImpl(AuthenticatedWebResourceProvider provider, com.google.common.util.concurrent.ListeningExecutorService executor)

Method Summary

Modifier and Type	Method	Description
<S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Void>	create(RelationInstance<S,T> relationInstance)	Deprecated. since 7.0.1.
<S extends Relatable,T extends Relatable> CompletionStage<Void>	createCompletionStage(RelationInstance<S,T> relationInstance)	Creates a directed relation between two relatable entities.
<S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Void>	delete(RelationInstance<S,T> relationInstance)	Deprecated. since 7.0.1.
<S extends Relatable,T extends Relatable> CompletionStage<Void>	deleteCompletionStage(RelationInstance<S,T> relationInstance)	Remove a relation if it exists between a source and a target relatable entity
<S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Boolean>	isRelated(S source, RelationDescriptor<S,T> relationDescriptor, T target)	Deprecated. since 7.0.1.
<S extends Relatable,T extends Relatable> CompletionStage<Boolean>	isRelatedCompletionStage(S source, RelationDescriptor<S,T> relationDescriptor, T target)	Determine whether a given source and target are related by the given relation

Methods inherited from class com.atlassian.confluence.rest.client.AbstractRemoteService

addExpansions, addPageRequest, addPageRequestParams, deleteCompletionStage, deleteCompletionStage, deleteFuture, deleteFuture, getCompletionStage, getCompletionStageGenericCollection, getCompletionStageMap, getCompletionStageMapOfPageResponses, getCompletionStageOptional, getCompletionStagePageResponseList, getCompletionStageSearchPageResponseList, getExecutor, getFuture, getFutureGenericCollection, getFutureMap, getFutureMapOfPageResponses, getFutureOption, getFuturePageResponseList, newExperimentalRestWebResource, newRestWebResource, postCompletionStage, postCompletionStage, postCompletionStage, postCompletionStageToPageResponse, postFuture, postFuture, postFuture, postFutureToPageResponse, putCompletionStage, putFuture

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RemoteRelationServiceImpl

public RemoteRelationServiceImpl(AuthenticatedWebResourceProvider provider,
                                 com.google.common.util.concurrent.ListeningExecutorService executor)

Method Detail

create

@Deprecated
public <S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Void> create(RelationInstance<S,T> relationInstance)
                                                                                                   throws ServiceException

Deprecated.

since 7.0.1. Use createCompletionStage(RelationInstance) instead.

Description copied from interface: RemoteRelationService

Creates a directed relation between two relatable entities.

For example, when a user favourites a space a SpaceFavouriteRelation is created from the user to the space:

     relationService.create(RelationInstance.builder(user, new SpaceFavouriteRelation(), space).build));
 

Specified by:

create in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Parameters:

relationInstance - the relation to create

Returns:

the newly created relationInstance

Throws:

ServiceException - if validation fails

delete

@Deprecated
public <S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Void> delete(RelationInstance<S,T> relationInstance)
                                                                                                   throws ServiceException

Deprecated.

since 7.0.1. Use deleteCompletionStage(RelationInstance) instead.

Description copied from interface: RemoteRelationService

Remove a relation if it exists between a source and a target relatable entity

Specified by:

delete in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Parameters:

relationInstance - relation to be deleted

Throws:

ServiceException - if validation fails

createCompletionStage

public <S extends Relatable,T extends Relatable> CompletionStage<Void> createCompletionStage(RelationInstance<S,T> relationInstance)
                                                                                            throws ServiceException

Description copied from interface: RemoteRelationService

Creates a directed relation between two relatable entities.

For example, when a user favourites a space a SpaceFavouriteRelation is created from the user to the space:

     relationService.create(RelationInstance.builder(user, new SpaceFavouriteRelation(), space).build));
 

Specified by:

createCompletionStage in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Parameters:

relationInstance - the relation to create

Returns:

the newly created relationInstance

Throws:

ServiceException - if validation fails

deleteCompletionStage

public <S extends Relatable,T extends Relatable> CompletionStage<Void> deleteCompletionStage(RelationInstance<S,T> relationInstance)
                                                                                            throws ServiceException

Description copied from interface: RemoteRelationService

Remove a relation if it exists between a source and a target relatable entity

Specified by:

deleteCompletionStage in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Parameters:

relationInstance - relation to be deleted

Throws:

ServiceException - if validation fails

isRelated

@Deprecated
public <S extends Relatable,T extends Relatable> com.atlassian.util.concurrent.Promise<Boolean> isRelated(S source,
                                                                                                                RelationDescriptor<S,T> relationDescriptor,
                                                                                                                T target)

Deprecated.

since 7.0.1. Use isRelatedCompletionStage(Relatable, RelationDescriptor, Relatable) instead.

Description copied from interface: RemoteRelationService

Determine whether a given source and target are related by the given relation

Specified by:

isRelated in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Returns:

true if the relation exists between the given source and target

isRelatedCompletionStage

public <S extends Relatable,T extends Relatable> CompletionStage<Boolean> isRelatedCompletionStage(S source,
                                                                                                         RelationDescriptor<S,T> relationDescriptor,
                                                                                                         T target)

Description copied from interface: RemoteRelationService

Determine whether a given source and target are related by the given relation

Specified by:

isRelatedCompletionStage in interface RemoteRelationService

Type Parameters:

S - type of the source entity

T - type of the target entity

Returns:

true if the relation exists between the given source and target