Método MailboxProcessor.PostAndReply<'Msg,'Reply> (F#)

Artigo
06/10/2015

Posta uma mensagem para um agente e espera uma resposta no canal de forma síncrona.

Caminho do namespace/módulo: Microsoft.FSharp.Control

Assembly: FSharp.Core (em FSharp.Core.dll)

// Signature:
member this.PostAndReply : (AsyncReplyChannel<'Reply> -> 'Msg) * ?int -> 'Reply

// Usage:
mailboxProcessor.PostAndReply (buildMessage)
mailboxProcessor.PostAndReply (buildMessage, timeout = timeout)

Parâmetros

buildMessage
Tipo: AsyncReplyChannel<'Reply> -> 'Msg

A função para incorporar AsyncReplyChannel à mensagem a ser enviada.
timeout
Tipo: int

Um parâmetro de tempo limite opcional (em milissegundos) para aguardar uma mensagem de resposta. O padrão é -1 que corresponde a Infinite.

Valor de retorno

A resposta do agente.

Comentários

A mensagem é gerada ao aplicar buildMessage a um novo canal de resposta a ser incorporado à mensagem. O agente receptor deve processar essa mensagem e invocar o método Reply neste canal de resposta precisamente uma vez.

Exemplo

O exemplo de código a seguir mostra como iniciar um agente do processador de caixa de correio. Nesse exemplo, cada linha de entrada do console é lançada em uma fila de mensagens. O programa lê cada mensagem e responde usando um canal de resposta. Quando a mensagem especial "Stop" é recebida, a resposta Stop é enviada e o programa é fechado.

open System

type Message = string * AsyncReplyChannel<string>

let formatString = "Message number {0} was received. Message contents: {1}" 

let printThreadId note =

    // Append the thread ID.
    printfn "%d : %s" System.Threading.Thread.CurrentThread.ManagedThreadId note


let agent = MailboxProcessor<Message>.Start(fun inbox ->
    let rec loop n =
        async {
                let! (message, replyChannel) = inbox.Receive();
                printThreadId "MailboxProcessor" 
                if (message = "Stop") then
                    replyChannel.Reply("Stopping.")
                else
                    replyChannel.Reply(String.Format(formatString, n, message))
                do! loop (n + 1)
        }
    loop 0)

printfn "Mailbox Processor Test"
printfn "Type some text and press Enter to submit a message."
printfn "Type 'Stop' to close the program." 

let rec loop() =
    printf "> " 
    let input = Console.ReadLine()
    printThreadId("Console loop")
    let reply = agent.PostAndReply(fun replyChannel -> input, replyChannel)
    if (reply <> "Stopping.") then
        printfn "Reply: %s" reply
        loop()
    else
        ()
loop()

printfn "Press Enter to continue."
Console.ReadLine() |> ignore

Segue uma sessão de exemplo.

Plataformas

Windows 8, Windows 7, Windows Server 2012, Windows Server 2008 R2

Informações de versão

Versões da biblioteca principal F#

Suporte em: 2.0, 4.0, Portable

Consulte também

Referência

Classe Control.MailboxProcessor<'Msg> (F#)

Namespace Microsoft.FSharp.Control (F#)

Partilhar via