mirror of
https://github.com/roytam1/palemoon26.git
synced 2026-05-27 21:48:27 +00:00
109 lines
3.7 KiB
Java
109 lines
3.7 KiB
Java
/*
|
|
* ====================================================================
|
|
* 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 ch.boye.httpclientandroidlib.impl.cookie;
|
|
|
|
import java.util.Collection;
|
|
import java.util.HashMap;
|
|
import java.util.Map;
|
|
|
|
import ch.boye.httpclientandroidlib.annotation.NotThreadSafe;
|
|
|
|
import ch.boye.httpclientandroidlib.cookie.CookieAttributeHandler;
|
|
import ch.boye.httpclientandroidlib.cookie.CookieSpec;
|
|
|
|
/**
|
|
* Abstract cookie specification which can delegate the job of parsing,
|
|
* validation or matching cookie attributes to a number of arbitrary
|
|
* {@link CookieAttributeHandler}s.
|
|
*
|
|
*
|
|
* @since 4.0
|
|
*/
|
|
@NotThreadSafe // HashMap is not thread-safe
|
|
public abstract class AbstractCookieSpec implements CookieSpec {
|
|
|
|
/**
|
|
* Stores attribute name -> attribute handler mappings
|
|
*/
|
|
private final Map<String, CookieAttributeHandler> attribHandlerMap;
|
|
|
|
/**
|
|
* Default constructor
|
|
* */
|
|
public AbstractCookieSpec() {
|
|
super();
|
|
this.attribHandlerMap = new HashMap<String, CookieAttributeHandler>(10);
|
|
}
|
|
|
|
public void registerAttribHandler(
|
|
final String name, final CookieAttributeHandler handler) {
|
|
if (name == null) {
|
|
throw new IllegalArgumentException("Attribute name may not be null");
|
|
}
|
|
if (handler == null) {
|
|
throw new IllegalArgumentException("Attribute handler may not be null");
|
|
}
|
|
this.attribHandlerMap.put(name, handler);
|
|
}
|
|
|
|
/**
|
|
* Finds an attribute handler {@link CookieAttributeHandler} for the
|
|
* given attribute. Returns <tt>null</tt> if no attribute handler is
|
|
* found for the specified attribute.
|
|
*
|
|
* @param name attribute name. e.g. Domain, Path, etc.
|
|
* @return an attribute handler or <tt>null</tt>
|
|
*/
|
|
protected CookieAttributeHandler findAttribHandler(final String name) {
|
|
return this.attribHandlerMap.get(name);
|
|
}
|
|
|
|
/**
|
|
* Gets attribute handler {@link CookieAttributeHandler} for the
|
|
* given attribute.
|
|
*
|
|
* @param name attribute name. e.g. Domain, Path, etc.
|
|
* @throws IllegalStateException if handler not found for the
|
|
* specified attribute.
|
|
*/
|
|
protected CookieAttributeHandler getAttribHandler(final String name) {
|
|
CookieAttributeHandler handler = findAttribHandler(name);
|
|
if (handler == null) {
|
|
throw new IllegalStateException("Handler not registered for " +
|
|
name + " attribute.");
|
|
} else {
|
|
return handler;
|
|
}
|
|
}
|
|
|
|
protected Collection<CookieAttributeHandler> getAttribHandlers() {
|
|
return this.attribHandlerMap.values();
|
|
}
|
|
|
|
}
|