/*
 * JBoss, Home of Professional Open Source.
 * Copyright 2014 Red Hat, Inc., and individual contributors
 * as indicated by the @author tags.
 *
 * Licensed 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.
 */

package io.undertow.util;

import java.util.Collections;
import java.util.IdentityHashMap;
import java.util.List;
import java.util.Map;

import io.undertow.UndertowMessages;

A thing which can have named attachments.
Author:David M. Lloyd
/** * A thing which can have named attachments. * * @author <a href="mailto:david.lloyd@redhat.com">David M. Lloyd</a> */
public abstract class AbstractAttachable implements Attachable { private Map<AttachmentKey<?>, Object> attachments;
{@inheritDoc}
/** * {@inheritDoc} */
@Override public <T> T getAttachment(final AttachmentKey<T> key) { if (key == null || attachments == null) { return null; } return (T) attachments.get(key); }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public <T> List<T> getAttachmentList(AttachmentKey<? extends List<T>> key) { if (key == null || attachments == null) { return Collections.emptyList(); } List<T> list = (List<T>) attachments.get(key); if (list == null) { return Collections.emptyList(); } return list; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public <T> T putAttachment(final AttachmentKey<T> key, final T value) { if (key == null) { throw UndertowMessages.MESSAGES.argumentCannotBeNull("key"); } if(attachments == null) { attachments = createAttachmentMap(); } return (T) attachments.put(key, value); } protected Map<AttachmentKey<?>, Object> createAttachmentMap() { return new IdentityHashMap<>(5); }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public <T> T removeAttachment(final AttachmentKey<T> key) { if (key == null || attachments == null) { return null; } return (T) attachments.remove(key); }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public <T> void addToAttachmentList(final AttachmentKey<AttachmentList<T>> key, final T value) { if (key != null) { if(attachments == null) { attachments = createAttachmentMap(); } final Map<AttachmentKey<?>, Object> attachments = this.attachments; final AttachmentList<T> list = (AttachmentList<T>) attachments.get(key); if (list == null) { final AttachmentList<T> newList = new AttachmentList<>(((ListAttachmentKey<T>) key).getValueClass()); attachments.put(key, newList); newList.add(value); } else { list.add(value); } } } }