cachedinetaddress.java

来自「spam source codejasen-0.9jASEN - java An」· Java 代码 · 共 141 行

/*
 * @(#)CachedInetAddress.java	11/11/2004
 *
 * Copyright (c) 2004, 2005  jASEN.org
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *   1. Redistributions of source code must retain the above copyright notice,
 *      this list of conditions and the following disclaimer.
 *
 *   2. Redistributions in binary form must reproduce the above copyright
 *      notice, this list of conditions and the following disclaimer in
 *      the documentation and/or other materials provided with the distribution.
 *
 *   3. The names of the authors may not be used to endorse or promote products
 *      derived from this software without specific prior written permission.
 *
 *   4. Any modification or additions to the software must be contributed back
 *      to the project.
 *
 *   5. Any investigation or reverse engineering of source code or binary to
 *      enable emails to bypass the filters, and hence inflict spam and or viruses
 *      onto users who use or do not use jASEN could subject the perpetrator to
 *      criminal and or civil liability.
 *
 * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES,
 * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
 * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JASEN.ORG,
 * OR ANY CONTRIBUTORS TO THIS SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT,
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
 * OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */
package org.jasen.net;

import java.io.Serializable;
import java.net.InetAddress;
import java.net.UnknownHostException;

/**
 * <P>
 * 	Used by the rudamentary caching system employed by the JasenInetAddressResolver.
 * </P>
 * <p>
 * 	It is recommended that an alternate resolver be used in production.
 * </p>
 * @author Jason Polites
 */
public class CachedInetAddress implements Serializable
{
    protected String hostname;
    protected InetAddress inetAddress;
    protected long ttl;
    protected long cachedAt;
    protected boolean unknown = false;

    /**
     *
     */
    public CachedInetAddress() {
        super ();
    }

    /**
     * Gets the time (in seconds) that this address was cached
     * @return The time the address was last cached
     */
    public long getCachedAt() {
        return cachedAt;
    }

    /**
     * Sets the time (in seconds) that this address was cached
     * @param cachedAt
     */
    public void setCachedAt(long cachedAt) {
        this.cachedAt = cachedAt;
    }

    /**
     * Gets the cached InetAddress
     * @return The InetAddress object corresponding to this cache entry
     * @throws UnknownHostException if the address was an "unknown" address
     */
    public InetAddress getInetAddress() throws UnknownHostException {
        if(unknown) {
           throw new UnknownHostException(hostname);
        }
        else
        {
            return inetAddress;
        }
    }

    /**
     * Sets the cached InetAddress
     * @param inetAddress
     */
    public void setInetAddress(InetAddress inetAddress) {
        this.inetAddress = inetAddress;
    }

    /**
     * Gets the Time To Live in seconds
     * @return
     */
    public long getTtl() {
        return ttl;
    }

    /**
     * Sets the Time To Live in seconds
     * @param ttl
     */
    public void setTtl(long ttl) {
        this.ttl = ttl;
    }

    /**
     * Gets the hostname for this address
     * @return The hostname for this address
     */
    public String getHostname() {
        return hostname;
    }

    /**
     * Sets the hostname for this address
     * @param host
     */
    public void setHostname(String host) {
        this.hostname = host;
    }
}