/**
 * ServiceSoap.java
 *
 * This file was auto-generated from WSDL
 * by the Apache Axis 1.2RC1 Sep 29, 2004 (08:29:40 EDT) WSDL2Java emitter.
 */

package de.jacomac.sayings;

public interface ServiceSoap extends java.rmi.Remote {

    /**
     * getSayingDetailsById returns a saying / proverb for a given
     * id.
     */
    public de.jacomac.sayings.Saying getSayingDetailsById(int getSayingDetailsByIdId) throws java.rmi.RemoteException;

    /**
     * getMetaData() gives you info about the version, latest entry
     * date, number of entries etc.
     */
    public de.jacomac.sayings.MetaData getMetaData() throws java.rmi.RemoteException;

    /**
     * This let's you look for sayings in the DB. Use the ID of the
     * language with this method (can be retrieved from getAvailableLanguages()).
     * Use -1 for 'any' language.
     */
    public de.jacomac.sayings.ArrayOfSaying searchForSayingsUsingLanguageId(java.lang.String searchForSayingsUsingLanguageIdSearchString, int searchForSayingsUsingLanguageIdLanguageType) throws java.rmi.RemoteException;

    /**
     * This let's you look for sayings in the DB. Use the name of
     * a European language with this method. Use 'any' if you don't want
     * to limit your search to just one language.
     */
    public de.jacomac.sayings.ArrayOfSaying searchForSayingsUsingLanguageName(java.lang.String searchForSayingsUsingLanguageNameSearchString, java.lang.String searchForSayingsUsingLanguageNameLanguageType) throws java.rmi.RemoteException;

    /**
     * Here you can retrieve all the possible languages and their
     * corresponding identifiers.
     */
    public de.jacomac.sayings.ArrayOfLanguageType getAvailableLanguages() throws java.rmi.RemoteException;

    /**
     * Here you can contribute a new Saying to the Database, if you
     * like. When your proposal could be stored, you will recieve a confirmation
     * message, otherwise an exception / soapFault will be thrown.
     */
    public java.lang.String contributeNewSaying(de.jacomac.sayings.ProposedNewSaying contributeNewSayingPropSaying) throws java.rmi.RemoteException;
}
