craterdog.accounting.LedgerAttributes Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of java-digital-accounting Show documentation

This project defines a set of interfaces and classes that implement digital accounting.

There is a newer version: 1.6

Show newest version

/************************************************************************
 * Copyright (c) Crater Dog Technologies(TM).  All Rights Reserved.     *
 ************************************************************************
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.        *
 *                                                                      *
 * This code is free software; you can redistribute it and/or modify it *
 * under the terms of The MIT License (MIT), as published by the Open   *
 * Source Initiative. (See http://opensource.org/licenses/MIT)          *
 ************************************************************************/
package craterdog.accounting;

import com.fasterxml.jackson.annotation.JsonAnyGetter;
import com.fasterxml.jackson.annotation.JsonAnySetter;
import craterdog.notary.Watermark;
import craterdog.smart.SmartObject;
import java.net.URI;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * This class defines the attributes that make up a digital ledger that records transactions.
 *
 * @author Derk Norton
 */
public final class LedgerAttributes extends SmartObject {

    /**
     * The location of this document.
     */
    public URI myLocation;

    /**
     * The channel type (e.g. identity, token, etc.) for the ledger.  The channel type
     * describes what all the transactions maintained by this ledger have in common.
     */
    public String channelType;

    /**
     * The location of the channel associated with the transactions.
     */
    public URI channelLocation;

    /**
     * The lifetime of the transaction along with the version of the algorithm used to sign it.
     */
    public Watermark watermark;


    /*
     * This map is used to hold any JSON attributes that are not mappable to the existing attributes.
     */
    private final Map additional = new LinkedHashMap<>();


    /**
     * This method returns the value of the additional attribute associated with the specified
     * name, or null if none exists.
     *
     * @param name The name of the additional attribute to be returned.
     * @return The value of the attribute.
     */
    public Object get(String name) {
        return additional.get(name);
    }


    /**
     * This method allows the setting of additional attributes that are not explicitly defined.
     *
     * @param name The name of the additional attribute.
     * @param value The value to be associated with this attribute name.
     * @return Any previous attribute value associated with this attribute name.
     */
    @JsonAnySetter
    public Object put(String name, Object value) {
        return additional.put(name, value);
    }


    /**
     * This method returns a map of the additional attributes that are not explicitly defined.  It
     * is primarily used by the Jackson parser during deserialization of the corresponding JSON.
     *
     * @return A map containing the additional attributes.
     */
    @JsonAnyGetter
    public Map any() {
        return additional;
    }

}