001// Copyright 2009 The Apache Software Foundation
002//
003// Licensed under the Apache License, Version 2.0 (the "License");
004// you may not use this file except in compliance with the License.
005// You may obtain a copy of the License at
006//
007//     http://www.apache.org/licenses/LICENSE-2.0
008//
009// Unless required by applicable law or agreed to in writing, software
010// distributed under the License is distributed on an "AS IS" BASIS,
011// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
012// See the License for the specific language governing permissions and
013// limitations under the License.
014
015package org.apache.tapestry5.ioc.annotations;
016
017import java.lang.annotation.Documented;
018import static java.lang.annotation.ElementType.METHOD;
019import static java.lang.annotation.ElementType.TYPE;
020import java.lang.annotation.Retention;
021import static java.lang.annotation.RetentionPolicy.RUNTIME;
022import java.lang.annotation.Target;
023
024/**
025 * An optional annotation that may be placed on a service building method of a module, or on the implementation class
026 * (when using service binding via the {@link org.apache.tapestry5.ioc.ServiceBinder}). The annotation overrides the
027 * default id for services (the default service id is the simple name of the service interface).
028 */
029@Target({ TYPE, METHOD })
030@Retention(RUNTIME)
031@Documented
032@UseWith({AnnotationUseContext.SERVICE, AnnotationUseContext.MODULE})
033public @interface ServiceId
034{
035    /**
036     * An identifier of a service.
037     */
038    String value();
039}