Enum Publish 

pub enum Publish {
    Initial {
        body: String,
        expires: Duration,
    },
    Refresh {
        tag: String,
        expires: Duration,
    },
    Modify {
        tag: String,
        body: String,
        expires: Duration,
    },
    Remove {
        tag: String,
    },
    Empty,
}

What a PUBLISH asked for (RFC 3903 §4.1, §6).

The three operations differ only by what is present, which is why they are read as one thing and dispatched on: an entity tag with no body is a refresh, with a body a modify, and with Expires: 0 a removal.

Variants

Initial

First publication: a body and no entity tag.

Fields

body: String

The document.

expires: Duration

How long it should live.

Refresh

A refresh: an entity tag and no body.

Fields

tag: String

The tag identifying the state.

expires: Duration

The new lifetime.

Modify

A modification: an entity tag and a body.

Fields

tag: String

The tag identifying the state.

body: String

The replacement document.

expires: Duration

The new lifetime.

Remove

A removal: an entity tag and Expires: 0.

Fields

tag: String

The tag identifying the state.

Empty

Neither a body nor a tag — §6 step 5 says reject this.

It is not an empty publication: there is nothing to publish and nothing to identify, so there is no operation it could be.

Implementations

impl Publish

pub fn read( tag: Option<String>, body: Option<String>, expires: Duration, ) -> Self

Read what a PUBLISH is asking for, from its tag, body and expiry.

Trait Implementations

impl Clone for Publish

fn clone(&self) -> Publish

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Publish

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Publish

fn eq(&self, other: &Publish) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Publish