at.jku.fim.rubanetra.protocol.activity.http

Class HttpActivity

java.lang.Object

java.util.EventObject

at.jku.fim.rubanetra.protocol.activity.AbstractActivity

at.jku.fim.rubanetra.protocol.activity.AbstractReplaceableActivity

at.jku.fim.rubanetra.protocol.activity.http.HttpActivity

All Implemented Interfaces:

CsvRecordOutputWriter, Activity, ReplaceableActivity, Serializable

public class HttpActivity
extends AbstractReplaceableActivity

A high level aggregation of a HttpRequestActivity and a HttpResponseActivity. Usually instances of this class are created directly by Drools rules, i.e. a request is matched to a response by one or several rules. Additionally, this class defines several optional fields, e.g. a potential preceding Dns-Match to this Http-Activity and multiple HttpImageActivity objects may be aggregated as well.

See Also:

Serialized Form

Field Summary

Fields inherited from class at.jku.fim.rubanetra.protocol.activity.AbstractActivity

PROPERTY_ADD_FRAME_NUMBERS, PROPERTY_NEW_END_INSTANT, PROPERTY_NEW_START_INSTANT

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
HttpActivity(HttpRequestActivity req, HttpResponseActivity resp) Constructs a new Http-Activity and replaces both, the passed request and the response.

Method Summary

Modifier and Type	Method and Description
void	addImageActivity(HttpImageActivity imgAct) Adds and replaces a Http image activity which origins may be considered to lie within this HTTP activity.
String	getDestinationAddressAsString() An address that can be interpreted as the destination address for this activity.
DnsActivity	getDnsMatch() The interpretation of this field depends on the actual specification of the rule that filled this variable in the first place.
Set<HttpImageActivity>	getImageActivities() The interpretation of this field depends on the actual definition of the Drools rules that will fill this set.
HttpRequestActivity	getRequest()
HttpResponseActivity	getResponse()
String	getSourceAddressAsString() An address that can be interpreted as the source address for this activity.
void	setDnsMatch(DnsActivity dnsMatch) Calling this method results in the following actions: if this method was called previously, the old dnsMatch object is will no longer considered to be a replaced activity and the assigned frames are removed from the frame set the dnsMatch reference is saved and the DNS activity will be replaced
String	toString()

Methods inherited from class at.jku.fim.rubanetra.protocol.activity.AbstractReplaceableActivity

isReplaced, replaceActivity, setReplaced

Methods inherited from class at.jku.fim.rubanetra.protocol.activity.AbstractActivity

addOptionalField, addPropertyChangeListener, addPropertyChangeListener, extendActivity, getActivityType, getCompoundFrameNumbers, getDescription, getEndInstant, getEndTimestamp, getOptionalFields, getStartInstant, getStartTimestamp, isExcludedFromOutput, removePropertyChangeListener, removePropertyChangeListener, removeReplacedActivity, setDescription, setDestinationAddress, setEndInstant, setExcludedFromOutput, setSourceAddress, setStartInstant, writeCsvRecord

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

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

Methods inherited from interface at.jku.fim.rubanetra.protocol.activity.Activity

addPropertyChangeListener, addPropertyChangeListener, getActivityType, getCompoundFrameNumbers, getDescription, getEndInstant, getEndTimestamp, getOptionalFields, getStartInstant, getStartTimestamp, isExcludedFromOutput, removePropertyChangeListener, removePropertyChangeListener, setExcludedFromOutput

Constructor Detail

HttpActivity

public HttpActivity(HttpRequestActivity req,
                    HttpResponseActivity resp)

Constructs a new Http-Activity and replaces both, the passed request and the response.

Parameters:

req - the request that is followed by ...

resp - ... the response for the request

Method Detail

getResponse

public HttpResponseActivity getResponse()

Returns:

the Http response for the getRequest()

getRequest

public HttpRequestActivity getRequest()

Returns:

the Http request preceding the getResponse()

getDnsMatch

public DnsActivity getDnsMatch()

The interpretation of this field depends on the actual specification of the rule that filled this variable in the first place.

Returns:

a potential DNS-based query leading to the represented Http request/response

setDnsMatch

public void setDnsMatch(DnsActivity dnsMatch)

Calling this method results in the following actions:

• if this method was called previously, the old dnsMatch object is will no longer considered to be a replaced activity and the assigned frames are removed from the frame set
• the dnsMatch reference is saved and the DNS activity will be replaced

Parameters:

dnsMatch - a DNS activity that potentially led to this HTTP activity (speculative)

getImageActivities

public Set<HttpImageActivity> getImageActivities()

The interpretation of this field depends on the actual definition of the Drools rules that will fill this set.

Returns:

a collection of activities that potentially originated from this HTTP activity.

addImageActivity

public void addImageActivity(HttpImageActivity imgAct)

Adds and replaces a Http image activity which origins may be considered to lie within this HTTP activity. The image activities are currently excluded from output, unless this is overridden manually.

Parameters:

imgAct - a image activity that was caused by this HTTP activity

getSourceAddressAsString

public String getSourceAddressAsString()

Description copied from interface: Activity

An address that can be interpreted as the source address for this activity. Usually this address should correspond to a human readable value. Because different protocols may be defining different address formats and types, the returned value is highly dependant on the actual implementation and may be empty or null if no source address exists at all.

Specified by:

getSourceAddressAsString in interface Activity

Overrides:

getSourceAddressAsString in class AbstractActivity

Returns:

a human-readable protocol-dependant source address or null if no such address exists for this activity

getDestinationAddressAsString

public String getDestinationAddressAsString()

Description copied from interface: Activity

An address that can be interpreted as the destination address for this activity. Usually this address should correspond to a human readable value. Because different protocols may be defining different address formats and types, the returned value is highly dependant on the actual implementation and may be empty or null if no destination address exists at all.

Specified by:

getDestinationAddressAsString in interface Activity

Overrides:

getDestinationAddressAsString in class AbstractActivity

Returns:

a human-readable protocol-dependant destination address or null if no such address exists for this activity

toString

public String toString()

Overrides:

toString in class AbstractActivity