001package org.apache.archiva.redback.rest.api.services;
002/*
003 * Licensed to the Apache Software Foundation (ASF) under one
004 * or more contributor license agreements.  See the NOTICE file
005 * distributed with this work for additional information
006 * regarding copyright ownership.  The ASF licenses this file
007 * to you under the Apache License, Version 2.0 (the
008 * "License"); you may not use this file except in compliance
009 * with the License.  You may obtain a copy of the License at
010 *
011 *   http://www.apache.org/licenses/LICENSE-2.0
012 *
013 * Unless required by applicable law or agreed to in writing,
014 * software distributed under the License is distributed on an
015 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
016 * KIND, either express or implied.  See the License for the
017 * specific language governing permissions and limitations
018 * under the License.
019 */
020
021import org.apache.archiva.redback.authorization.RedbackAuthorization;
022
023import javax.ws.rs.GET;
024import javax.ws.rs.Path;
025import javax.ws.rs.Produces;
026import javax.ws.rs.QueryParam;
027import javax.ws.rs.core.MediaType;
028import java.util.Properties;
029
030/**
031 * @author Olivier Lamy
032 * @since 1.4
033 */
034@Path( "/utilServices/" )
035public interface UtilServices
036{
037
038    @Path( "getBundleResources" )
039    @GET
040    @Produces( { MediaType.TEXT_PLAIN } )
041    @RedbackAuthorization( noRestriction = true )
042    String getI18nResources( @QueryParam( "locale" ) String locale )
043        throws RedbackServiceException;
044
045    /**
046     * <b>not intended to be exposed as a REST service.</b>
047     * will load i18N resource org/apache/archiva/redback/users/messages in default en then in the asked locale.
048     * @param locale
049     * @return
050     * @throws RedbackServiceException
051     */
052    Properties getI18nProperties( String locale )
053        throws RedbackServiceException;
054
055
056}