/*
    * Copyright 2007-2011 smartics, Kronseder & Reiner GmbH
    *
    * 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 de.smartics.exceptions.i18n.message;
  
  import java.util.Locale;
  import java.util.ResourceBundle;
  
  /**
   * Helper to render the messages of an exception in a structured multi-line
   * text.
   *
   * @author <a href="mailto:robert.reiner@smartics.de">Robert Reiner</a>
   * @version $Revision:591 $
   */
  class StructuredTextHandler extends AbstractTextHandler
  {
    // ********************************* Fields *********************************
  
    // --- constants ------------------------------------------------------------
  
    // --- members --------------------------------------------------------------
  
    // ****************************** Initializer *******************************
  
    // ****************************** Constructors ******************************
  
    /**
     * Default constructor.
     *
     * @param bundleBaseName the fully qualified base name of the bundle to use.
     * @param resourceKey the localization key to fetch messages from message
     *          bundles.
     */
    public StructuredTextHandler(final String bundleBaseName,
        final String resourceKey)
    {
      super(bundleBaseName, resourceKey);
    }
  
    // ****************************** Inner Classes *****************************
  
    // ********************************* Methods ********************************
  
    // --- init -----------------------------------------------------------------
  
    // --- get&set --------------------------------------------------------------
  
    // --- business -------------------------------------------------------------
  
    /**
     * Returns the structured and localized message for the given locale,
     * returning each part of information that is provided.
     *
     * @param throwable the throwable to construct the localized message.
     * @param locale the locale for which the message is requested.
     * @param loader the loader to read the message bundle.
     * @return returns the localized message of this exception.
     */
    @Override
    public String getMessage(final Throwable throwable, final Locale locale,
        final ClassLoader loader)
    {
      final StringBuilder buffer = new StringBuilder();
      final ResourceBundle messageBundle =
          ResourceBundle.getBundle(
              "de.smartics.exceptions.i18n.message.StructuredTextBundle", locale,
              loader);
  
      appendMessage(throwable, locale, loader, buffer, MessageType.TITLE, null);
  
      appendWhatHasHappendMessage(throwable, locale, loader, buffer,
          messageBundle);
  
      appendMessage(throwable, locale, loader, buffer,
          MessageType.IMPLICATIONS_ON_CURRENT_TASK,
          messageBundle.getString("header.implications"));
  
      appendMessage(throwable, locale, loader, buffer,
          MessageType.WHAT_TO_DO_NOW,
          messageBundle.getString("header.whatToDoNow"));
  
      appendMessage(throwable, locale, loader, buffer, MessageType.URL,
          messageBundle.getString("header.url"));
  
      return buffer.toString();
    }
 
   private void appendWhatHasHappendMessage(final Throwable throwable,
       final Locale locale, final ClassLoader loader,
       final StringBuilder buffer, final ResourceBundle messageBundle)
   {
     final String summaryMessage =
         internalGetLocalizedMessage(throwable, resourceKey, locale,
             MessageType.SUMMARY, loader);
     final String detailsMessage =
         internalGetLocalizedMessage(throwable, resourceKey, locale,
             MessageType.DETAILS, loader);
     if (summaryMessage != null || detailsMessage != null)
     {
       buffer.append(' ')
           .append(messageBundle.getString("header.whatHasHappened"))
           .append('\n');
       if (summaryMessage != null)
       {
         buffer.append("  ");
         if (detailsMessage != null)
         {
           buffer.append(
               messageBundle.getString("header.whatHasHappened.summary"))
               .append(": ");
         }
 
         buffer.append(summaryMessage).append('\n');
       }
       if (detailsMessage != null)
       {
         buffer.append("  ");
         if (summaryMessage != null)
         {
           buffer.append(
               messageBundle.getString("header.whatHasHappened.details"))
               .append(": ");
         }
         buffer.append(detailsMessage).append('\n');
       }
     }
   }
 
   private void appendMessage(final Throwable throwable, final Locale locale,
       final ClassLoader loader, final StringBuilder buffer,
       final MessageType type, final String headline)
   {
     final String message =
         internalGetLocalizedMessage(throwable, resourceKey, locale, type,
             loader);
     if (message != null)
     {
       if (headline != null)
       {
         buffer.append(' ').append(headline).append("\n  ");
       }
 
       buffer.append(message).append('\n');
     }
   }
 
   // --- object basics --------------------------------------------------------
 
 }