1 /****************************************************************
2 * Licensed to the Apache Software Foundation (ASF) under one *
3 * or more contributor license agreements. See the NOTICE file *
4 * distributed with this work for additional information *
5 * regarding copyright ownership. The ASF licenses this file *
6 * to you under the Apache License, Version 2.0 (the *
7 * "License"); you may not use this file except in compliance *
8 * with the License. You may obtain a copy of the License at *
9 * *
10 * http://www.apache.org/licenses/LICENSE-2.0 *
11 * *
12 * Unless required by applicable law or agreed to in writing, *
13 * software distributed under the License is distributed on an *
14 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY *
15 * KIND, either express or implied. See the License for the *
16 * specific language governing permissions and limitations *
17 * under the License. *
18 ****************************************************************/
19
20 package org.apache.james.jspf.core;
21
22 import org.apache.james.jspf.core.exceptions.NeutralException;
23 import org.apache.james.jspf.core.exceptions.NoneException;
24 import org.apache.james.jspf.core.exceptions.PermErrorException;
25 import org.apache.james.jspf.core.exceptions.TempErrorException;
26
27 /**
28 *
29 * Listeners which should get called for a SPFCheck when the DNSResponse is aviable should implement
30 * this interface.
31 */
32 public interface SPFCheckerDNSResponseListener {
33
34 /**
35 * Continue the check for SPF with the given values and the given DNSResponse
36 *
37 * @param response
38 * The DNSResponse which should be used to run the check
39 * @param session
40 * The SPFSession which should be used to run the check
41 * @throws PermErrorException
42 * Get thrown if an error was detected
43 * @throws NoneException
44 * Get thrown if no Record was found
45 * @throws TempErrorException
46 * Get thrown if a DNS problem was detected
47 * @throws NeutralException
48 * Get thrown if the result should be neutral
49 */
50 public DNSLookupContinuation onDNSResponse(DNSResponse response, SPFSession session) throws PermErrorException, NoneException, TempErrorException, NeutralException;
51
52 }