<commit_before>package org.motechproject.server.service;

import org.motechproject.outbox.model.OutboundVoiceMessage;
import org.motechproject.outbox.model.OutboundVoiceMessageStatus;


/**
 * Voice Outbox Service interface
 * Provides methods to get information and manage messages in the party voice outbox.
 * Each party (Patient, Nurse, Doctor, etc.) can have a voice outbox.
 *
 *
 * @author Igor (<EMAIL>)
 */
public interface VoiceOutboxService {

    /**
     * Adds the given outbound voice message to the parties' voice outbox.A party determines by party ID
     * in the given outbound voice message
     *
     * @param outboundVoiceMessage - outbound voice message to be added to the outbox
     */
    public void addMessage(OutboundVoiceMessage outboundVoiceMessage);

    /**
     * Returns the next pending message from the outbox of the party identified by the given party ID.
     * A next pending message in a party outbox considered a not expired message with status "Pending" that belongs
     * to this party, has the oldest creation time and  highest priority.
     *
     * @param partyId - unique identifier of the party from
     * @return OutboundVoiceMessage
     */
    public OutboundVoiceMessage getNextPendingMessage(String partyId);
<commit_msg>MOTECH-481 Minor Java doc correction.<commit_after>package org.motechproject.server.service;

import org.motechproject.outbox.model.OutboundVoiceMessage;
import org.motechproject.outbox.model.OutboundVoiceMessageStatus;


/**
 * Voice Outbox Service interface
 * Provides methods to get information and manage messages in the party voice outbox.
 * Each party (Patient, Nurse, Doctor, etc.) can have a voice outbox.
 *
 *
 * @author Igor (<EMAIL>)
 */
public interface VoiceOutboxService {

    /**
     * Adds the given outbound voice message to the parties' voice outbox.A party determines by party ID
     * in the given outbound voice message
     *
     * @param outboundVoiceMessage - outbound voice message to be added to the outbox
     */
    public void addMessage(OutboundVoiceMessage outboundVoiceMessage);

    /**
     * Returns the next pending message from the outbox of the party identified by the given party ID, or NULL
     * if there is no more pending messages in the outbox.
     * A next pending message is a not expired message with the status "Pending" that belongs
     * to this party, the oldest creation time and the highest priority among other pending messages in the party outbox.
     *
     * @param partyId - unique identifier of the party from
     * @return OutboundVoiceMessage
     */
    public OutboundVoiceMessage getNextPendingMessage(String partyId);

{'fraction_non_alphanumeric': 0.06130841121495327, 'fraction_numerical': 0.0011214953271028037, 'mean_word_length': 3.6058519793459554, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1699722', 'n_tokens_mistral': 711, 'n_tokens_neox': 677, 'n_words': 295}