Java tutorial
/* * ==================================================================== * Licensed to the Apache Software Foundation (ASF) under one * or more contributor license agreements. See the NOTICE file * distributed with this work for additional information * regarding copyright ownership. The ASF licenses this file * to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance * with the License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, * software distributed under the License is distributed on an * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY * KIND, either express or implied. See the License for the * specific language governing permissions and limitations * under the License. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Software Foundation. For more * information on the Apache Software Foundation, please see * <http://www.apache.org/>. * */ package org.apache.http.HC4.impl.execchain; import java.io.Closeable; import java.io.IOException; import java.util.concurrent.TimeUnit; import org.apache.commons.logging.Log; import org.apache.http.HC4.HttpClientConnection; import org.apache.http.HC4.annotation.ThreadSafe; import org.apache.http.HC4.concurrent.Cancellable; import org.apache.http.HC4.conn.HttpClientConnectionManager; import org.apache.http.HC4.conn.ConnectionReleaseTrigger; /** * Internal connection holder. * * @since 4.3 */ @ThreadSafe class ConnectionHolder implements ConnectionReleaseTrigger, Cancellable, Closeable { private final Log log; private final HttpClientConnectionManager manager; private final HttpClientConnection managedConn; private volatile boolean reusable; private volatile Object state; private volatile long validDuration; private volatile TimeUnit tunit; private volatile boolean released; public ConnectionHolder(final Log log, final HttpClientConnectionManager manager, final HttpClientConnection managedConn) { super(); this.log = log; this.manager = manager; this.managedConn = managedConn; } public boolean isReusable() { return this.reusable; } public void markReusable() { this.reusable = true; } public void markNonReusable() { this.reusable = false; } public void setState(final Object state) { this.state = state; } public void setValidFor(final long duration, final TimeUnit tunit) { synchronized (this.managedConn) { this.validDuration = duration; this.tunit = tunit; } } @Override public void releaseConnection() { synchronized (this.managedConn) { if (this.released) { return; } this.released = true; if (this.reusable) { this.manager.releaseConnection(this.managedConn, this.state, this.validDuration, this.tunit); } else { try { this.managedConn.close(); log.debug("Connection discarded"); } catch (final IOException ex) { if (this.log.isDebugEnabled()) { this.log.debug(ex.getMessage(), ex); } } finally { this.manager.releaseConnection(this.managedConn, null, 0, TimeUnit.MILLISECONDS); } } } } @Override public void abortConnection() { synchronized (this.managedConn) { if (this.released) { return; } this.released = true; try { this.managedConn.shutdown(); log.debug("Connection discarded"); } catch (final IOException ex) { if (this.log.isDebugEnabled()) { this.log.debug(ex.getMessage(), ex); } } finally { this.manager.releaseConnection(this.managedConn, null, 0, TimeUnit.MILLISECONDS); } } } @Override public boolean cancel() { final boolean alreadyReleased = this.released; log.debug("Cancelling request execution"); abortConnection(); return !alreadyReleased; } public boolean isReleased() { return this.released; } @Override public void close() throws IOException { abortConnection(); } }