/*
 * Copyright (c) 2013 Cisco Systems, Inc. and others.  All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v1.0 which accompanies this distribution,
 * and is available at http://www.eclipse.org/legal/epl-v10.html
 */
package org.opendaylight.controller.sal.binding.api;

import org.opendaylight.controller.md.sal.binding.api.BindingService;

/**
 * Session-specific instance of the broker functionality.
 *
 * <p>
 * BindingAwareService is marker interface for infrastructure services provided
 * by the SAL. These services are session-specific, each
 * {@link BindingAwareConsumer} and {@link BindingAwareProvider} usually has own
 * instance of the service with it's own context.
 *
 * <p>
 * The consumer's (or provider's) instance of specific service could be obtained by invoking
 * {@link org.opendaylight.controller.sal.binding.api.BindingAwareBroker.ConsumerContext#getSALService(Class)}
 * method on session assigned to the consumer.
 *
 * <p>
 * {@link org.opendaylight.controller.sal.binding.api.BindingAwareBroker.ConsumerContext}
 * and {@link BindingAwareProvider} may seem similar, but provider provides YANG model-based functionality and
 * {@link BindingAwareProvider} exposes the necessary supporting functionality
 * to implement specific functionality of YANG and to reuse it in the
 * development of {@link BindingAwareConsumer}s and {@link BindingAwareProvider}s.
 *
 * @deprecated Use {@link BindingService} instead.
 */
@Deprecated
public interface BindingAwareService {

}