/**
 * Copyright 2012 Netflix, Inc.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.netflix.hystrix.examples.demo;

/**
 * POJO for holding the result of a CreditCardAuthorization
 */
public class CreditCardAuthorizationResult {

    public static CreditCardAuthorizationResult createSuccessResponse(String transactionID, String authorizationCode) {
        return new CreditCardAuthorizationResult(true, transactionID, authorizationCode, false);
    }

    public static CreditCardAuthorizationResult createDuplicateSuccessResponse(String transactionID, String authorizationCode) {
        return new CreditCardAuthorizationResult(true, transactionID, authorizationCode, true);
    }

    public static CreditCardAuthorizationResult createFailedResponse(String message) {
        return new CreditCardAuthorizationResult(false, message, null, false);
    }

    private final boolean success;
    private final boolean isDuplicate;
    private final String authorizationCode;
    private final String transactionID;
    private final String errorMessage;

    /**
     * Private constructor that normally would be a horrible API as it re-uses different arguments for different state.
     * 
     * @param success
     * @param value
     * @param isResponseDuplicate
     *            boolean whether the response is the result of a duplicate transaction returning a previously submitted transaction result
     *            <p>
     *            This is for handling the idempotent double-posting scenario, such as retries after timeouts.
     */
    private CreditCardAuthorizationResult(boolean success, String value, String value2, boolean isResponseDuplicate) {
        this.success = success;
        this.isDuplicate = isResponseDuplicate;
        if (success) {
            this.transactionID = value;
            this.authorizationCode = value2;
            this.errorMessage = null;
        } else {
            this.transactionID = null;
            this.errorMessage = value;
            this.authorizationCode = null;
        }
    }

    public boolean isSuccess() {
        return success;
    }

    /**
     * Whether this result was a duplicate transaction.
     * 
     * @return boolean
     */
    public boolean isDuplicateTransaction() {
        return isDuplicate;
    }

    /**
     * If <code>isSuccess() == true</code> this will return the authorization code.
     * <p>
     * If <code>isSuccess() == false</code> this will return NULL.
     * 
     * @return
     */
    public String getAuthorizationCode() {
        return authorizationCode;
    }

    /**
     * If <code>isSuccess() == true</code> this will return the transaction ID.
     * <p>
     * If <code>isSuccess() == false</code> this will return NULL.
     * 
     * @return
     */
    public String getTransactionID() {
        return transactionID;
    }

    /**
     * If <code>isSuccess() == false</code> this will return the error message.
     * <p>
     * If <code>isSuccess() == true</code> this will return NULL.
     * 
     * @return
     */
    public String getErrorMessage() {
        return errorMessage;
    }
}

@@ -3001,33 +3001,40 @@
  %0A     * @return
+ String
 %0A
-
      */%0A    publ
@@ -3289,32 +3289,39 @@
  %0A     * @return
+ String
 %0A     */%0A    pub
@@ -3554,32 +3554,32 @@
 n NULL.%0A     * %0A
-
      * @return%0A 
@@ -3576,16 +3576,23 @@
  @return
+ String
 %0A     */

Update javadoc