com.amazonaws.xray.entities

Interface Segment

All Superinterfaces:

AutoCloseable, Entity

All Known Implementing Classes:

DummySegment, FacadeSegment, SegmentImpl

public interface Segment
extends Entity

Method Summary

Modifier and Type	Method and Description
void	close()
boolean	end() Ends the segment.
Map<String,Object>	getAnnotations()
String	getOrigin()
Segment	getParentSegment()
String	getResourceArn()
Map<String,Object>	getService()
String	getUser()
boolean	isSampled()
void	putAllService(Map<String,Object> all) Puts information about this service.
void	putService(String key, Object object) Puts information about this service.
void	setOrigin(String origin)
void	setResourceArn(String resourceArn)
void	setSampled(boolean sampled)
void	setService(Map<String,Object> service)
void	setUser(String user)

Methods inherited from interface com.amazonaws.xray.entities.Entity

addException, addSubsegment, decrementReferenceCount, generateId, getAws, getCause, getCreator, getEndTime, getHttp, getId, getMetadata, getName, getNamespace, getParent, getParentId, getReferenceCount, getSql, getStartTime, getSubsegments, getSubsegmentsLock, getTotalSize, getTraceId, incrementReferenceCount, isEmitted, isError, isFault, isInProgress, isThrottle, prettySerialize, putAllAws, putAllHttp, putAllSql, putAnnotation, putAnnotation, putAnnotation, putAws, putHttp, putMetadata, putMetadata, putSql, removeSubsegment, serialize, setAnnotations, setAws, setCreator, setEmitted, setEndTime, setError, setFault, setHttp, setId, setInProgress, setMetadata, setNamespace, setParent, setParentId, setSql, setStartTime, setSubsegmentsLock, setThrottle, setTraceId

Method Detail

end

boolean end()

Ends the segment. Sets the end time to the current time. Sets inProgress to false.

Returns:

true if 1) the reference count is less than or equal to zero and 2) sampled is true

isSampled

boolean isSampled()

Returns:

the sampled

setSampled

void setSampled(boolean sampled)

Parameters:

sampled - the sampled to set

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getResourceArn

String getResourceArn()

Returns:

the resourceArn

setResourceArn

void setResourceArn(String resourceArn)

Parameters:

resourceArn - the resourceArn to set

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getUser

String getUser()

Returns:

the user

setUser

void setUser(String user)

Parameters:

user - the user to set

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getOrigin

String getOrigin()

Returns:

the origin

setOrigin

void setOrigin(String origin)

Parameters:

origin - the origin to set

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getService

Map<String,Object> getService()

Returns:

the service

setService

void setService(Map<String,Object> service)

Parameters:

service - the service to set

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getAnnotations

Map<String,Object> getAnnotations()

Specified by:

getAnnotations in interface Entity

Returns:

the annotations

putService

void putService(String key,
                Object object)

Puts information about this service.

Parameters:

key - the key under which the service information is stored

object - the service information

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

putAllService

void putAllService(Map<String,Object> all)

Puts information about this service.

Parameters:

all - the service information to set.

Throws:

AlreadyEmittedException - if the entity has already been emitted to the X-Ray daemon and the ContextMissingStrategy of the AWSXRayRecorder used to create this entity is configured to throw exceptions

getParentSegment

Segment getParentSegment()

Specified by:

getParentSegment in interface Entity

close

void close()

Specified by:

close in interface AutoCloseable