org.mitre.cybox.objects.URLHistory Maven / Gradle / Ivy
Show all versions of stix Show documentation
/**
* Copyright (c) 2015, The MITRE Corporation. All rights reserved.
* See LICENSE for complete terms.
*/
//
// This file was generated by the JavaTM Architecture for XML Binding(JAXB) Reference Implementation, v2.2.5-2
// See http://java.sun.com/xml/jaxb
// Any modifications to this file will be lost upon recompilation of the source schema.
// Generated on: 2015.06.23 at 10:59:44 AM EDT
//
package org.mitre.cybox.objects;
import java.io.StringReader;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import javax.xml.bind.JAXBContext;
import javax.xml.bind.JAXBElement;
import javax.xml.bind.JAXBException;
import javax.xml.bind.Unmarshaller;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;
import javax.xml.namespace.QName;
import javax.xml.transform.stream.StreamSource;
import org.jvnet.jaxb2_commons.lang.Equals;
import org.jvnet.jaxb2_commons.lang.EqualsStrategy;
import org.jvnet.jaxb2_commons.lang.HashCode;
import org.jvnet.jaxb2_commons.lang.HashCodeStrategy;
import org.jvnet.jaxb2_commons.lang.JAXBEqualsStrategy;
import org.jvnet.jaxb2_commons.lang.JAXBHashCodeStrategy;
import org.jvnet.jaxb2_commons.lang.JAXBToStringStrategy;
import org.jvnet.jaxb2_commons.lang.ToString;
import org.jvnet.jaxb2_commons.lang.ToStringStrategy;
import org.jvnet.jaxb2_commons.locator.ObjectLocator;
import org.jvnet.jaxb2_commons.locator.util.LocatorUtils;
import org.mitre.cybox.common_2.CustomPropertiesType;
import org.mitre.cybox.common_2.ObjectPropertiesType;
import org.mitre.cybox.common_2.ToolInformationType;
import org.mitre.stix.DocumentUtilities;
import org.mitre.stix.STIXSchema;
import org.mitre.stix.ValidationEventHandler;
/**
* The URLHistoryObject type is intended to characterize the stored URL history for a particular web browser.
*
* Java class for URLHistoryObjectType complex type.
*
*
The following schema fragment specifies the expected content contained within this class.
*
*
* <complexType name="URLHistoryObjectType">
* <complexContent>
* <extension base="{http://cybox.mitre.org/common-2}ObjectPropertiesType">
* <sequence>
* <element name="Browser_Information" type="{http://cybox.mitre.org/common-2}ToolInformationType" minOccurs="0"/>
* <element name="URL_History_Entry" type="{http://cybox.mitre.org/objects#URLHistoryObject-1}URLHistoryEntryType" maxOccurs="unbounded" minOccurs="0"/>
* </sequence>
* </extension>
* </complexContent>
* </complexType>
*
*
*
*/
@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(name = "URLHistoryObjectType", namespace = "http://cybox.mitre.org/objects#URLHistoryObject-1", propOrder = {
"browserInformation", "urlHistoryEntries" })
@XmlRootElement(name = "URL_History", namespace = "http://cybox.mitre.org/objects#URLHistoryObject-1")
public class URLHistory extends ObjectPropertiesType implements Equals,
HashCode, ToString {
@XmlElement(name = "Browser_Information")
protected ToolInformationType browserInformation;
@XmlElement(name = "URL_History_Entry")
protected List urlHistoryEntries;
/**
* Default no-arg constructor
*
*/
public URLHistory() {
super();
}
/**
* Fully-initialising value constructor
*
*/
public URLHistory(final CustomPropertiesType customProperties,
final QName objectReference,
final ToolInformationType browserInformation,
final List urlHistoryEntries) {
super(customProperties, objectReference);
this.browserInformation = browserInformation;
this.urlHistoryEntries = urlHistoryEntries;
}
/**
* Gets the value of the browserInformation property.
*
* @return
* possible object is
* {@link ToolInformationType }
*
*/
public ToolInformationType getBrowserInformation() {
return browserInformation;
}
/**
* Sets the value of the browserInformation property.
*
* @param value
* allowed object is
* {@link ToolInformationType }
*
*/
public void setBrowserInformation(ToolInformationType value) {
this.browserInformation = value;
}
/**
* Gets the value of the urlHistoryEntries property.
*
*
* This accessor method returns a reference to the live list,
* not a snapshot. Therefore any modification you make to the
* returned list will be present inside the JAXB object.
* This is why there is not a set method for the urlHistoryEntries property.
*
*
* For example, to add a new item, do as follows:
*
* getURLHistoryEntries().add(newItem);
*
*
*
*
* Objects of the following type(s) are allowed in the list
* {@link URLHistoryEntryType }
*
*
*/
public List getURLHistoryEntries() {
if (urlHistoryEntries == null) {
urlHistoryEntries = new ArrayList();
}
return this.urlHistoryEntries;
}
public boolean equals(ObjectLocator thisLocator, ObjectLocator thatLocator,
Object object, EqualsStrategy strategy) {
if (!(object instanceof URLHistory)) {
return false;
}
if (this == object) {
return true;
}
if (!super.equals(thisLocator, thatLocator, object, strategy)) {
return false;
}
final URLHistory that = ((URLHistory) object);
{
ToolInformationType lhsBrowserInformation;
lhsBrowserInformation = this.getBrowserInformation();
ToolInformationType rhsBrowserInformation;
rhsBrowserInformation = that.getBrowserInformation();
if (!strategy.equals(LocatorUtils.property(thisLocator,
"browserInformation", lhsBrowserInformation), LocatorUtils
.property(thatLocator, "browserInformation",
rhsBrowserInformation), lhsBrowserInformation,
rhsBrowserInformation)) {
return false;
}
}
{
List lhsURLHistoryEntries;
lhsURLHistoryEntries = (((this.urlHistoryEntries != null) && (!this.urlHistoryEntries
.isEmpty())) ? this.getURLHistoryEntries() : null);
List rhsURLHistoryEntries;
rhsURLHistoryEntries = (((that.urlHistoryEntries != null) && (!that.urlHistoryEntries
.isEmpty())) ? that.getURLHistoryEntries() : null);
if (!strategy.equals(LocatorUtils.property(thisLocator,
"urlHistoryEntries", lhsURLHistoryEntries), LocatorUtils
.property(thatLocator, "urlHistoryEntries",
rhsURLHistoryEntries), lhsURLHistoryEntries,
rhsURLHistoryEntries)) {
return false;
}
}
return true;
}
public boolean equals(Object object) {
final EqualsStrategy strategy = JAXBEqualsStrategy.INSTANCE;
return equals(null, null, object, strategy);
}
public int hashCode(ObjectLocator locator, HashCodeStrategy strategy) {
int currentHashCode = super.hashCode(locator, strategy);
{
ToolInformationType theBrowserInformation;
theBrowserInformation = this.getBrowserInformation();
currentHashCode = strategy.hashCode(LocatorUtils.property(locator,
"browserInformation", theBrowserInformation),
currentHashCode, theBrowserInformation);
}
{
List theURLHistoryEntries;
theURLHistoryEntries = (((this.urlHistoryEntries != null) && (!this.urlHistoryEntries
.isEmpty())) ? this.getURLHistoryEntries() : null);
currentHashCode = strategy.hashCode(LocatorUtils.property(locator,
"urlHistoryEntries", theURLHistoryEntries),
currentHashCode, theURLHistoryEntries);
}
return currentHashCode;
}
public int hashCode() {
final HashCodeStrategy strategy = JAXBHashCodeStrategy.INSTANCE;
return this.hashCode(null, strategy);
}
public URLHistory withBrowserInformation(ToolInformationType value) {
setBrowserInformation(value);
return this;
}
public URLHistory withURLHistoryEntries(URLHistoryEntryType... values) {
if (values != null) {
for (URLHistoryEntryType value : values) {
getURLHistoryEntries().add(value);
}
}
return this;
}
public URLHistory withURLHistoryEntries(
Collection values) {
if (values != null) {
getURLHistoryEntries().addAll(values);
}
return this;
}
@Override
public URLHistory withCustomProperties(CustomPropertiesType value) {
setCustomProperties(value);
return this;
}
@Override
public URLHistory withObjectReference(QName value) {
setObjectReference(value);
return this;
}
public String toString() {
final ToStringStrategy strategy = JAXBToStringStrategy.INSTANCE;
final StringBuilder buffer = new StringBuilder();
append(null, buffer, strategy);
return buffer.toString();
}
public StringBuilder append(ObjectLocator locator, StringBuilder buffer,
ToStringStrategy strategy) {
strategy.appendStart(locator, this, buffer);
appendFields(locator, buffer, strategy);
strategy.appendEnd(locator, this, buffer);
return buffer;
}
public StringBuilder appendFields(ObjectLocator locator,
StringBuilder buffer, ToStringStrategy strategy) {
super.appendFields(locator, buffer, strategy);
{
ToolInformationType theBrowserInformation;
theBrowserInformation = this.getBrowserInformation();
strategy.appendField(locator, this, "browserInformation", buffer,
theBrowserInformation);
}
{
List theURLHistoryEntries;
theURLHistoryEntries = (((this.urlHistoryEntries != null) && (!this.urlHistoryEntries
.isEmpty())) ? this.getURLHistoryEntries() : null);
strategy.appendField(locator, this, "urlHistoryEntries", buffer,
theURLHistoryEntries);
}
return buffer;
}
/**
* Returns A Document representation of this instance that is not formatted.
*
* @return The Document representation for this instance.
*/
public org.w3c.dom.Document toDocument() {
return toDocument(false);
}
/**
* Returns A Document representation for this instance.
*
* @param prettyPrint
* True for pretty print, otherwise false
*
* @return The Document representation for this instance.
*/
public org.w3c.dom.Document toDocument(boolean prettyPrint) {
return DocumentUtilities.toDocument(toJAXBElement(), prettyPrint);
}
/**
* Returns JAXBElement for this instance.
*
* @return The JAXBElement for this instance.
*/
@SuppressWarnings({ "rawtypes", "unchecked" })
public JAXBElement toJAXBElement() {
QName qualifiedName = STIXSchema.getQualifiedName(this);
return new JAXBElement(qualifiedName, URLHistory.class, this);
}
/**
* Returns String representation of this instance that is not formatted.
*
* @return The String containing the XML mark-up.
*/
public String toXMLString() {
return toXMLString(false);
}
/**
* Returns XML String for JAXB Document Object Model object.
*
* @param prettyPrint
* True for pretty print, otherwise false
*
* @return The String containing the XML mark-up.
*/
public String toXMLString(boolean prettyPrint) {
return DocumentUtilities.toXMLString(toDocument(), prettyPrint);
}
/**
* Creates URLHistory instance for XML String
*
* @param text
* XML String for the document
* @return The URLHistory instance for the passed XML String
*/
public static URLHistory fromXMLString(String text) {
JAXBContext jaxbContext;
try {
jaxbContext = JAXBContext.newInstance(URLHistory.class.getPackage()
.getName());
Unmarshaller unmarshaller = jaxbContext.createUnmarshaller();
unmarshaller.setSchema(STIXSchema.getInstance().getSchema());
unmarshaller.setEventHandler(new ValidationEventHandler());
StreamSource streamSource = new StreamSource(new StringReader(text));
return (URLHistory) unmarshaller.unmarshal(streamSource);
} catch (JAXBException e) {
throw new RuntimeException(e);
}
}
/**
* Validates the XML representation of this URLHistory instance
* Returning true indicating a successful validation, false if not.
*
* @return boolean
*/
public boolean validate() {
return STIXSchema.getInstance().validate(toXMLString());
}
}