com.opengamma.strata.product.SecurityInfoBuilder Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of strata-product Show documentation
Domain objects describing trades and products in financial markets
There is a newer version: 2.12.48
/*
 * Copyright (C) 2016 - present by OpenGamma Inc. and the OpenGamma group of companies
 *
 * Please see distribution for license.
 */
package com.opengamma.strata.product;

import java.util.HashMap;
import java.util.Map;

import com.opengamma.strata.collect.ArgChecker;

/**
 * Builder to create {@code SecurityInfo}.
 * 
 * This builder allows a {@link SecurityInfo} to be created.
 */
public final class SecurityInfoBuilder {

  /**
   * The security identifier.
   * 

   * This identifier uniquely identifies the security within the system.
   */
  private SecurityId id;
  /**
   * The information about the security price.
   * 

   * This provides information about the security price.
   * This can be used to convert the price into a monetary value.
   */
  private SecurityPriceInfo priceInfo;
  /**
   * The security attributes.
   * 

   * Security attributes, provide the ability to associate arbitrary information
   * with a security in a key-value map.
   */
  private final Map, Object> attributes = new HashMap<>();

  // creates an empty instance
  SecurityInfoBuilder() {
  }

  // creates a populated instance
  SecurityInfoBuilder(SecurityId id, SecurityPriceInfo priceInfo, Map, Object> attributes) {
    this.id = id;
    this.priceInfo = priceInfo;
    this.attributes.putAll(attributes);
  }

  //-----------------------------------------------------------------------
  /**
   * Sets the security identifier.
   * 

   * This identifier uniquely identifies the security within the system.
   * 
   * @param id  the identifier
   * @return this, for chaining
   */
  public SecurityInfoBuilder id(SecurityId id) {
    this.id = ArgChecker.notNull(id, "id");
    return this;
  }

  /**
   * Sets the information about the security price.
   * 

   * This provides information about the security price.
   * This can be used to convert the price into a monetary value.
   * 
   * @param priceInfo  the price info
   * @return this, for chaining
   */
  public SecurityInfoBuilder priceInfo(SecurityPriceInfo priceInfo) {
    this.priceInfo = ArgChecker.notNull(priceInfo, "priceInfo");
    return this;
  }

  /**
   * Adds a security attribute to the map of attributes.
   * 
   * The attribute is added using {@code Map.put(type, value)} semantics.
   * 
   * @param  the type of the value
   * @param attributeType  the type providing meaning to the value
   * @param attributeValue  the value
   * @return this, for chaining
   */
  @SuppressWarnings("unchecked")
  public  SecurityInfoBuilder addAttribute(AttributeType attributeType, T attributeValue) {
    ArgChecker.notNull(attributeType, "attributeType");
    ArgChecker.notNull(attributeValue, "attributeValue");
    attributes.put(attributeType, attributeType.toStoredForm(attributeValue));
    return this;
  }

  /**
   * Builds the security information.
   * 
   * @return the security information
   */
  public SecurityInfo build() {
    return new SecurityInfo(id, priceInfo, attributes);
  }

}