1  /*
     2   * Copyright the original author or authors.
     3   * 
     4   * Licensed under the MOZILLA PUBLIC LICENSE, Version 1.1 (the "License");
     5   * you may not use this file except in compliance with the License.
     6   * You may obtain a copy of the License at
     7   * 
     8   *      http://www.mozilla.org/MPL/MPL-1.1.html
     9   * 
    10   * Unless required by applicable law or agreed to in writing, software
    11   * distributed under the License is distributed on an "AS IS" BASIS,
    12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    13   * See the License for the specific language governing permissions and
    14   * limitations under the License.
    15   */
    16  
    17  import org.as2lib.env.log.HierarchicalLogger;
    18  
    19  /**
    20   * {@code ConfigurableHierarchicalLogger} declares methods needed to configure
    21   * hierarchical loggers.
    22   * 
    23   * <p>Loggers that shall be used with the {@link LoggerHierarchy} repository must
    24   * implement this interface.
    25   *
    26   * @author Simon Wacker
    27   */
    28  interface org.as2lib.env.log.ConfigurableHierarchicalLogger extends HierarchicalLogger {
    29  	
    30  	/**
    31  	 * Sets the parent of this logger.
    32  	 *
    33  	 * <p>The parent is used to obtain needed configuration like handlers
    34  	 * and levels.
    35  	 * 
    36  	 * @param parent the parent of this logger
    37  	 */
    38  	public function setParent(parent:HierarchicalLogger):Void;
    39  	
    40  	/**
    41  	 * Sets the name of this logger.
    42  	 *
    43  	 * <p>The passed-in {@code name} must exist of the path as well as the actual
    44  	 * identifier. That means it must be fully qualified.
    45  	 * 
    46  	 * <p>The {@link LoggerHierarchy} prescribes that the different parts of the name
    47  	 * must be separated by periods. If you do not want to use it with the
    48  	 * {@code LoggerHierarchy} you can of course separate the different parts as you
    49  	 * please.
    50  	 *
    51  	 * @param name the name of this logger
    52  	 */
    53  	public function setName(name:String):Void;
    54  	
    55  }
as2api