1 /*_############################################################################ 2 _## 3 _## SNMP4J-Agent - RequestFactory.java 4 _## 5 _## Copyright (C) 2005-2007 Frank Fock (SNMP4J.org) 6 _## 7 _## Licensed under the Apache License, Version 2.0 (the "License"); 8 _## you may not use this file except in compliance with the License. 9 _## You may obtain a copy of the License at 10 _## 11 _## http://www.apache.org/licenses/LICENSE-2.0 12 _## 13 _## Unless required by applicable law or agreed to in writing, software 14 _## distributed under the License is distributed on an "AS IS" BASIS, 15 _## WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 16 _## See the License for the specific language governing permissions and 17 _## limitations under the License. 18 _## 19 _##########################################################################*/ 20 21 22 package org.snmp4j.agent.request; 23 24 import java.util.EventObject; 25 import org.snmp4j.agent.mo.snmp.CoexistenceInfo; 26 // for JavaDoc 27 import org.snmp4j.CommandResponderEvent; 28 29 /** 30 * The <code>RequestRactory</code> is a factory for (SNMP/AgentX) requests. 31 * 32 * @author Frank Fock 33 * @version 1.0 34 */ 35 public interface RequestFactory { 36 37 /** 38 * Creates a <code>Request</code> from a <code>CommandResponderEvent</code> 39 * responder event. 40 * @param initiatingEvent 41 * the initiating event instance, which is a 42 * {@link CommandResponderEvent} instance for SNMP4J by default. 43 * @param cinfo 44 * optional coexistence information that provides context and context 45 * engine ID independently from the SNMP version of the initiatingEvent. 46 * @return 47 * a Request instance. 48 */ 49 Request createRequest(EventObject initiatingEvent, CoexistenceInfo cinfo); 50 51 } 52