KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > log > output > DefaultOutputLogTarget


1 /* ====================================================================
2  * The Apache Software License, Version 1.1
3  *
4  * Copyright (c) 1997-2003 The Apache Software Foundation. All rights
5  * reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  * notice, this list of conditions and the following disclaimer.
13  *
14  * 2. Redistributions in binary form must reproduce the above copyright
15  * notice, this list of conditions and the following disclaimer in
16  * the documentation and/or other materials provided with the
17  * distribution.
18  *
19  * 3. The end-user documentation included with the redistribution,
20  * if any, must include the following acknowledgment:
21  * "This product includes software developed by the
22  * Apache Software Foundation (http://www.apache.org/)."
23  * Alternately, this acknowledgment may appear in the software
24  * itself, if and wherever such third-party acknowledgments
25  * normally appear.
26  *
27  * 4. The names "Jakarta", "Avalon", and "Apache Software Foundation"
28  * must not be used to endorse or promote products derived from this
29  * software without prior written permission. For written
30  * permission, please contact apache@apache.org.
31  *
32  * 5. Products derived from this software may not be called "Apache",
33  * nor may "Apache" appear in their name, without prior written
34  * permission of the Apache Software Foundation.
35  *
36  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
37  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
38  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
39  * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
40  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
41  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
42  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
43  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
44  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
45  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
46  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
47  * SUCH DAMAGE.
48  * ====================================================================
49  *
50  * This software consists of voluntary contributions made by many
51  * individuals on behalf of the Apache Software Foundation. For more
52  * information on the Apache Software Foundation, please see
53  * <http://www.apache.org/>.
54  */
55 package org.apache.log.output;
56
57 import java.io.OutputStream JavaDoc;
58 import java.io.OutputStreamWriter JavaDoc;
59 import java.io.Writer JavaDoc;
60 import org.apache.log.format.Formatter;
61 import org.apache.log.format.PatternFormatter;
62 import org.apache.log.output.io.WriterTarget;
63
64 /**
65  * This is a basic Output log target that writes to a stream.
66  * The format is specified via a string.
67  *
68  * @author <a HREF="mailto:donaldp@apache.org">Peter Donald</a>
69  * @deprecated Use org.apache.log.output.io.WriterTarget or
70  * org.apache.log.output.io.StreamTarget as appropriate
71  * as this class encourages unsafe behaviour
72  */
73 public class DefaultOutputLogTarget
74     extends WriterTarget
75 {
76     private static final String JavaDoc FORMAT =
77         "%7.7{priority} %5.5{time} [%8.8{category}] (%{context}): %{message}\\n%{throwable}";
78
79     /**
80      * Initialize the default pattern.
81      *
82      * @deprecated This is no longer the recomended way to set formatter. It is recomended
83      * that it be passed into constructor.
84      */
85     protected void initPattern()
86     {
87     }
88
89     public DefaultOutputLogTarget( final Formatter formatter )
90     {
91         this( new OutputStreamWriter JavaDoc( System.out ), formatter );
92     }
93
94     /**
95      * Default Constructor.
96      *
97      */
98     public DefaultOutputLogTarget()
99     {
100         this( new OutputStreamWriter JavaDoc( System.out ) );
101     }
102
103     /**
104      * Constructor that takes a stream arguement.
105      *
106      * @param output the output stream
107      */
108     public DefaultOutputLogTarget( final OutputStream JavaDoc output )
109     {
110         this( new OutputStreamWriter JavaDoc( output ) );
111     }
112
113     /**
114      * Constructor that takes a writer parameter.
115      *
116      * @param writer the Writer
117      */
118     public DefaultOutputLogTarget( final Writer JavaDoc writer )
119     {
120         this( writer, new PatternFormatter( FORMAT ) );
121     }
122
123     public DefaultOutputLogTarget( final Writer JavaDoc writer, final Formatter formatter )
124     {
125         super( writer, formatter );
126         initPattern();
127     }
128
129     /**
130      * Set the format string for this target.
131      *
132      * @param format the format string
133      * @deprecated This method is unsafe as it assumes formatter is PatternFormatter
134      * and accesses a protected attribute. Instead of calling this method
135      * It is recomended that a fully configured formatter is passed into
136      * constructor.
137      */
138     public void setFormat( final String JavaDoc format )
139     {
140         ( (PatternFormatter)m_formatter ).setFormat( format );
141     }
142 }
143
Popular Tags