1 /* 2 * Copyright 1999-2004 The Apache Software Foundation 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 12 * implied. 13 * 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 package org.apache.log.output.jms; 18 19 import javax.jms.JMSException; 20 import javax.jms.Message; 21 import javax.jms.Session; 22 import org.apache.log.LogEvent; 23 24 /** 25 * Interface that classes implement to build JMS Messages. 26 * 27 * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a> 28 * @author Peter Donald 29 */ 30 public interface MessageBuilder 31 { 32 33 /** 34 * Creation of a new message. 35 * @param session the session against which the message will be created 36 * @param event the log event 37 * @return the message 38 * @exception JMSException if a messaging error occurs 39 */ 40 Message buildMessage( Session session, LogEvent event ) 41 throws JMSException; 42 } 43