/*
 * CREDIT SUISSE IS WILLING TO LICENSE THIS SPECIFICATION TO YOU ONLY UPON THE CONDITION THAT YOU
 * ACCEPT ALL OF THE TERMS CONTAINED IN THIS AGREEMENT. PLEASE READ THE TERMS AND CONDITIONS OF THIS
 * AGREEMENT CAREFULLY. BY DOWNLOADING THIS SPECIFICATION, YOU ACCEPT THE TERMS AND CONDITIONS OF
 * THE AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY IT, SELECT THE "DECLINE" BUTTON AT THE
 * BOTTOM OF THIS PAGE. Specification: JSR-354 Money and Currency API ("Specification") Copyright
 * (c) 2012-2013, Credit Suisse All rights reserved.
 */
package javax.money;


Builder class for creating new instances of MonetaryContext adding detailed information about a MonetaryAmount instance. 

Note this class is NOT thread-safe.
See Also:
MonetaryAmount.getContext()/**
 * Builder class for creating new instances of {@link MonetaryContext} adding detailed information
 * about a {@link MonetaryAmount} instance.
 * <p>
 * Note this class is NOT thread-safe.
 *
 * @see javax.money.MonetaryAmount#getContext()
 */
public final class MonetaryContextBuilder extends AbstractContextBuilder<MonetaryContextBuilder, MonetaryContext> {

    private MonetaryContextBuilder(MonetaryContext monetaryContext) {
        importContext(monetaryContext);
    }

    
Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
acquire a specific amount type and additionally configure the amount factory with the attributes in this
query.
Params:
amountType – the target amount type, not null./**
     * Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
     * acquire a specific amount type and additionally configure the amount factory with the attributes in this
     * query.
     *
     * @param amountType the target amount type, not null.
     */
    private MonetaryContextBuilder(Class<? extends MonetaryAmount> amountType) {
        set(MonetaryContext.AMOUNT_TYPE, amountType);
    }


    
Set the maximal scale to be supported.
Params:
maxScale – the max scale, >= 0.
Returns:
this builder for chaining./**
     * Set the maximal scale to be supported.
     *
     * @param maxScale the max scale, >= 0.
     * @return this builder for chaining.
     */
    public MonetaryContextBuilder setMaxScale(int maxScale) {
        return set("maxScale", maxScale);
    }

    
Set the required precision.
Params:
precision – the precision, >= 0, 0 meaning unlimited.
Returns:
this builder for chaining./**
     * Set the required precision.
     *
     * @param precision the precision, >= 0, 0 meaning unlimited.
     * @return this builder for chaining.
     */
    public MonetaryContextBuilder setPrecision(int precision) {
        return set("precision", precision);
    }

    
Set the flag if the scale should fixed.
Params:
fixedScale – the fixed scale flag.
Returns:
this builder for chaining./**
     * Set the flag if the scale should fixed.
     *
     * @param fixedScale the fixed scale flag.
     * @return this builder for chaining.
     */
    public MonetaryContextBuilder setFixedScale(boolean fixedScale) {
        return set("fixedScale", fixedScale);
    }

    
Set the MonetaryAmount implementation class.
See Also:
MonetaryAmount.getContext()
Returns:
the implementation class of the containing amount instance, never null./**
     * Set the MonetaryAmount implementation class.
     *
     * @return the implementation class of the containing amount instance, never null.
     * @see javax.money.MonetaryAmount#getContext()
     */
    public MonetaryContextBuilder setAmountType(Class<? extends MonetaryAmount> amountType) {
        return set(MonetaryContext.AMOUNT_TYPE, amountType);
    }

    
Creates a new instance of MonetaryAmountFactoryQuery. 
Returns:
a new MonetaryAmountFactoryQuery instance./**
     * Creates a new instance of {@link MonetaryAmountFactoryQuery}.
     *
     * @return a new {@link MonetaryAmountFactoryQuery} instance.
     */
    public MonetaryContext build() {
        return new MonetaryContext(this);
    }

    
Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
acquire a specific amount type and additionally configure the amount factory with the attributes in this
query.
Returns:
a new MonetaryContextBuilder instance, never null./**
     * Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
     * acquire a specific amount type and additionally configure the amount factory with the attributes in this
     * query.
     *
     * @return a new {@link javax.money.MonetaryContextBuilder} instance, never null.
     */
    public static MonetaryContextBuilder of() {
        return of(MonetaryAmount.class);
    }

    
Creates a new builder, using an existing MonetaryContext as a template. 
Returns:
a new MonetaryContextBuilder instance, never null./**
     * Creates a new builder, using an existing {@link javax.money.MonetaryContext} as a template.
     *
     * @return a new {@link javax.money.MonetaryContextBuilder} instance, never null.
     */
    public static MonetaryContextBuilder of(MonetaryContext monetaryContext) {
        return new MonetaryContextBuilder(monetaryContext);
    }

    
Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
acquire a specific amount type and additionally configure the amount factory with the attributes in this
query.
Params:
amountType – the target amount type, not null.
Returns:
a new MonetaryContextBuilder instance, never null./**
     * Creates a new builder, hereby the target implementation type is required. This can be used to explicitly
     * acquire a specific amount type and additionally configure the amount factory with the attributes in this
     * query.
     *
     * @param amountType the target amount type, not null.
     * @return a new {@link javax.money.MonetaryContextBuilder} instance, never null.
     */
    public static MonetaryContextBuilder of(Class<? extends MonetaryAmount> amountType) {
        return new MonetaryContextBuilder(amountType);
    }

}