/*
 * Copyright 2014 Agorava
 *
 * 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 org.agorava.xing;

import java.util.List;

import org.agorava.xing.model.Group;

/**
 * Defines operations for retrieving data about groups.
 *
 * @author Werner Keil
 */
public interface GroupService {

    /**
     * Retrieve data for a specified group.
     *
     * @param groupId the ID of the group
     * @return a {@link Group} object
     * @throws ApiException if there is an error while communicating with Facebook.
     */
    Group getGroup(String groupId);

    /**
     * Retrieves a group's image as an array of bytes. Returns the image in Facebook's "normal" type.
     *
     * @param groupId the group ID
     * @return an array of bytes containing the group's image.
     * @throws ApiException if there is an error while communicating with Facebook.
     */
    byte[] getGroupImage(String groupId);

    /**
     * Search for groups. Returns up to 25 groups matching the query.
     *
     * @param query the search query (e.g., "Spring User Group")
     * @return a list of {@link Group}s matching the search query
     * @throws ApiException if there is an error while communicating with Facebook.
     */
    List<Group> search(String query);

    /**
     * Search for groups.
     *
     * @param query  the search query (e.g., "Spring User Group")
     * @param offset the offset into the matching groups list
     * @param limit  the maximum number of groups to return
     * @return a list of {@link Group}s matching the search query
     * @throws ApiException if there is an error while communicating with Facebook.
     */
    List<Group> search(String query, int offset, int limit);

}

@@ -943,34 +943,38 @@
      * @throws A
-pi
+gorava
 Exception if the
@@ -1291,34 +1291,38 @@
      * @throws A
-pi
+gorava
 Exception if the

Clean Exception names in JavaDoc