libzypp  17.32.4
zypp::PluginFrame Class Reference

Command frame for communication with PluginScript. More...

#include <zypp/PluginFrame.h>

Classes

struct  Impl
 PluginFrame implementation. More...
 

Public Types

using Exception = PluginFrameException
 Default exception type. More...
 
using HeaderList = std::multimap< std::string, std::string >
 The header list. More...
 
using HeaderListIterator = HeaderList::const_iterator
 Header list iterator. More...
 

Public Member Functions

 PluginFrame ()
 Default ctor (empty frame) More...
 
 PluginFrame (const std::string &command_r)
 Ctor taking the command. More...
 
 PluginFrame (const std::string &command_r, std::string body_r)
 Ctor taking command and body. More...
 
 PluginFrame (const std::string &command_r, HeaderInitializerList contents_r)
 Ctor taking the command and a HeaderInitializerList. More...
 
 PluginFrame (const std::string &command_r, std::string body_r, HeaderInitializerList contents_r)
 Ctor taking command, body and a HeaderInitializerList. More...
 
 PluginFrame (std::istream &stream_r)
 Ctor reading frame data from a stream. More...
 
bool empty () const
 Whether this is an empty frame. More...
 
 operator bool () const
 Evaluate in a boolean context (not an empty frame) More...
 
const std::string & command () const
 Return the frame command. More...
 
void setCommand (const std::string &command_r)
 Set the frame command. More...
 
bool isAckCommand () const
 Convenience to identify an ACK command. More...
 
bool isErrorCommand () const
 Convenience to identify an ERROR command. More...
 
bool isEnomethodCommand () const
 Convenience to identify an _ENOMETHOD command. More...
 
const std::string & body () const
 Return the frame body. More...
 
std::string & bodyRef ()
 Return a reference to the frame body. More...
 
void setBody (const std::string &body_r)
 Set the frame body. More...
 
const HeaderListheaderList () const
 The header list. More...
 
bool headerEmpty () const
 Whether header list is empty. More...
 
unsigned headerSize () const
 Return size of the header list. More...
 
HeaderListIterator headerBegin () const
 Return iterator pointing to the 1st header (or headerEnd) More...
 
HeaderListIterator headerEnd () const
 Return iterator pointing behind the last header. More...
 
void headerClear ()
 Clear the list of headers. More...
 
bool hasKey (const std::string &key_r) const
 Whether the header list contains at least one entry for key_r. More...
 
bool keyEmpty (const std::string &key_r) const
 
bool keySize (const std::string &key_r) const
 Return number of header entries for key_r. More...
 
HeaderListIterator keyBegin (const std::string &key_r) const
 Return iterator pointing to the 1st header for key_r (or keyEnd(key_r)) More...
 
HeaderListIterator keyEnd (const std::string &key_r) const
 Return iterator pointing behind the last header for key_r. More...
 
const std::string & getHeader (const std::string &key_r) const
 Return header value for key_r. More...
 
const std::string & getHeader (const std::string &key_r, const std::string &default_r) const
 Return header value for key_r or default_r if it does not exist. More...
 
const std::string & getHeaderNT (const std::string &key_r, const std::string &default_r=std::string()) const
 Not throwing version returing one of the matching header values or default_r string. More...
 
void setHeader (const std::string &key_r, const std::string &value_r=std::string())
 Set header for key_r removing all other occurrences of key_r. More...
 
void setHeader (HeaderInitializerList contents_r)
 Set a new header list. More...
 
void addHeader (const std::string &key_r, const std::string &value_r=std::string())
 Add header for key_r leaving already existing headers for key_r unchanged. More...
 
void addHeader (HeaderInitializerList contents_r)
 
void clearHeader (const std::string &key_r)
 Remove all headers for key_r. More...
 
std::ostream & writeTo (std::ostream &stream_r) const
 Write frame to stream. More...
 
std::istream & readFrom (std::istream &stream_r)
 Read frame from stream. More...
 

Static Public Member Functions

static const std::string & ackCommand ()
 "ACK" command. More...
 
static const std::string & errorCommand ()
 "ERROR" command. More...
 
static const std::string & enomethodCommand ()
 "_ENOMETHOD" command. More...
 
static std::ostream & writeTo (std::ostream &stream_r, const PluginFrame &frame_r)
 
static std::istream & readFrom (std::istream &stream_r, PluginFrame &frame_r)
 

Private Types

using HeaderInitializerList = const std::initializer_list< std::pair< std::string, std::string > > &
 

Private Member Functions

HeaderListheaderList ()
 Modifyalble header list for internal use only. More...
 

Private Attributes

RWCOW_pointer< Impl_pimpl
 Pointer to implementation. More...
 

Friends

std::ostream & operator<< (std::ostream &str, const PluginFrame &obj)
 
bool operator== (const PluginFrame &lhs, const PluginFrame &rhs)
 

Related Functions

(Note that these are not member functions.)

std::ostream & operator<< (std::ostream &str, const PluginFrame &obj)
 
std::ostream & dumpOn (std::ostream &str, const PluginFrame &obj)
 
std::istream & operator>> (std::istream &str, PluginFrame &obj)
 
bool operator== (const PluginFrame &lhs, const PluginFrame &rhs)
 
bool operator!= (const PluginFrame &lhs, const PluginFrame &rhs)
 

Detailed Description

Command frame for communication with PluginScript.

COMMAND
key:value header lines
multiline body separated from header
by an empty line and terminated by NUL.
^@
See also
PluginScript

Definition at line 40 of file PluginFrame.h.

Member Typedef Documentation

◆ HeaderInitializerList

using zypp::PluginFrame::HeaderInitializerList = const std::initializer_list<std::pair<std::string, std::string> > &
private

Definition at line 45 of file PluginFrame.h.

◆ Exception

Default exception type.

Definition at line 57 of file PluginFrame.h.

◆ HeaderList

using zypp::PluginFrame::HeaderList = std::multimap<std::string, std::string>

The header list.

Definition at line 135 of file PluginFrame.h.

◆ HeaderListIterator

using zypp::PluginFrame::HeaderListIterator = HeaderList::const_iterator

Header list iterator.

Definition at line 138 of file PluginFrame.h.

Constructor & Destructor Documentation

◆ PluginFrame() [1/6]

zypp::PluginFrame::PluginFrame ( )

Default ctor (empty frame)

Definition at line 260 of file PluginFrame.cc.

◆ PluginFrame() [2/6]

zypp::PluginFrame::PluginFrame ( const std::string &  command_r)

Ctor taking the command.

Exceptions
PluginFrameExceptionIf setCommand throws

Definition at line 264 of file PluginFrame.cc.

◆ PluginFrame() [3/6]

zypp::PluginFrame::PluginFrame ( const std::string &  command_r,
std::string  body_r 
)

Ctor taking command and body.

Exceptions
PluginFrameExceptionIf setCommand throws

Definition at line 268 of file PluginFrame.cc.

◆ PluginFrame() [4/6]

zypp::PluginFrame::PluginFrame ( const std::string &  command_r,
HeaderInitializerList  contents_r 
)

Ctor taking the command and a HeaderInitializerList.

Exceptions
PluginFrameExceptionIf setCommand throws

Definition at line 272 of file PluginFrame.cc.

◆ PluginFrame() [5/6]

zypp::PluginFrame::PluginFrame ( const std::string &  command_r,
std::string  body_r,
HeaderInitializerList  contents_r 
)

Ctor taking command, body and a HeaderInitializerList.

Exceptions
PluginFrameExceptionIf setCommand throws

Definition at line 276 of file PluginFrame.cc.

◆ PluginFrame() [6/6]

zypp::PluginFrame::PluginFrame ( std::istream &  stream_r)

Ctor reading frame data from a stream.

Exceptions
PluginFrameExceptionOn error reading from stream
PluginFrameExceptionOn error parsing the data

Definition at line 280 of file PluginFrame.cc.

Member Function Documentation

◆ ackCommand()

const std::string & zypp::PluginFrame::ackCommand ( )
static

"ACK" command.

Definition at line 242 of file PluginFrame.cc.

◆ errorCommand()

const std::string & zypp::PluginFrame::errorCommand ( )
static

"ERROR" command.

Definition at line 248 of file PluginFrame.cc.

◆ enomethodCommand()

const std::string & zypp::PluginFrame::enomethodCommand ( )
static

"_ENOMETHOD" command.

Definition at line 254 of file PluginFrame.cc.

◆ empty()

bool zypp::PluginFrame::empty ( ) const

Whether this is an empty frame.

Definition at line 284 of file PluginFrame.cc.

◆ operator bool()

zypp::PluginFrame::operator bool ( ) const
inlineexplicit

Evaluate in a boolean context (not an empty frame)

Definition at line 93 of file PluginFrame.h.

◆ command()

const std::string & zypp::PluginFrame::command ( ) const

Return the frame command.

Definition at line 287 of file PluginFrame.cc.

◆ setCommand()

void zypp::PluginFrame::setCommand ( const std::string &  command_r)

Set the frame command.

Exceptions
PluginFrameExceptionIf illegal command string (e.g. multiline)

Definition at line 290 of file PluginFrame.cc.

◆ isAckCommand()

bool zypp::PluginFrame::isAckCommand ( ) const
inline

Convenience to identify an ACK command.

Definition at line 106 of file PluginFrame.h.

◆ isErrorCommand()

bool zypp::PluginFrame::isErrorCommand ( ) const
inline

Convenience to identify an ERROR command.

Definition at line 110 of file PluginFrame.h.

◆ isEnomethodCommand()

bool zypp::PluginFrame::isEnomethodCommand ( ) const
inline

Convenience to identify an _ENOMETHOD command.

Definition at line 114 of file PluginFrame.h.

◆ body()

const std::string & zypp::PluginFrame::body ( ) const

Return the frame body.

Definition at line 293 of file PluginFrame.cc.

◆ bodyRef()

std::string & zypp::PluginFrame::bodyRef ( )

Return a reference to the frame body.

This may avoid creating unnecessary copies if you want to manipulate large body data.

std::string tmp;
frame.bodyRef().swap( tmp );

Definition at line 296 of file PluginFrame.cc.

◆ setBody()

void zypp::PluginFrame::setBody ( const std::string &  body_r)

Set the frame body.

Definition at line 299 of file PluginFrame.cc.

◆ headerList() [1/2]

PluginFrame::HeaderList & zypp::PluginFrame::headerList ( )
private

Modifyalble header list for internal use only.

Definition at line 305 of file PluginFrame.cc.

◆ headerList() [2/2]

const PluginFrame::HeaderList & zypp::PluginFrame::headerList ( ) const

The header list.

Definition at line 308 of file PluginFrame.cc.

◆ headerEmpty()

bool zypp::PluginFrame::headerEmpty ( ) const
inline

Whether header list is empty.

Definition at line 149 of file PluginFrame.h.

◆ headerSize()

unsigned zypp::PluginFrame::headerSize ( ) const
inline

Return size of the header list.

Definition at line 153 of file PluginFrame.h.

◆ headerBegin()

HeaderListIterator zypp::PluginFrame::headerBegin ( ) const
inline

Return iterator pointing to the 1st header (or headerEnd)

Definition at line 157 of file PluginFrame.h.

◆ headerEnd()

HeaderListIterator zypp::PluginFrame::headerEnd ( ) const
inline

Return iterator pointing behind the last header.

Definition at line 161 of file PluginFrame.h.

◆ headerClear()

void zypp::PluginFrame::headerClear ( )
inline

Clear the list of headers.

Definition at line 165 of file PluginFrame.h.

◆ hasKey()

bool zypp::PluginFrame::hasKey ( const std::string &  key_r) const
inline

Whether the header list contains at least one entry for key_r.

Definition at line 170 of file PluginFrame.h.

◆ keyEmpty()

bool zypp::PluginFrame::keyEmpty ( const std::string &  key_r) const
inline

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 174 of file PluginFrame.h.

◆ keySize()

bool zypp::PluginFrame::keySize ( const std::string &  key_r) const
inline

Return number of header entries for key_r.

Definition at line 178 of file PluginFrame.h.

◆ keyBegin()

HeaderListIterator zypp::PluginFrame::keyBegin ( const std::string &  key_r) const
inline

Return iterator pointing to the 1st header for key_r (or keyEnd(key_r))

Definition at line 182 of file PluginFrame.h.

◆ keyEnd()

HeaderListIterator zypp::PluginFrame::keyEnd ( const std::string &  key_r) const
inline

Return iterator pointing behind the last header for key_r.

Definition at line 186 of file PluginFrame.h.

◆ getHeader() [1/2]

const std::string & zypp::PluginFrame::getHeader ( const std::string &  key_r) const

Return header value for key_r.

Exceptions
PluginFrameExceptionIf no header for key_r exists.
PluginFrameExceptionIf multiple header for key_r exist.

Definition at line 311 of file PluginFrame.cc.

◆ getHeader() [2/2]

const std::string & zypp::PluginFrame::getHeader ( const std::string &  key_r,
const std::string &  default_r 
) const

Return header value for key_r or default_r if it does not exist.

Exceptions
PluginFrameExceptionIf multiple header for key_r exist.

Definition at line 314 of file PluginFrame.cc.

◆ getHeaderNT()

const std::string & zypp::PluginFrame::getHeaderNT ( const std::string &  key_r,
const std::string &  default_r = std::string() 
) const

Not throwing version returing one of the matching header values or default_r string.

Definition at line 317 of file PluginFrame.cc.

◆ setHeader() [1/2]

void zypp::PluginFrame::setHeader ( const std::string &  key_r,
const std::string &  value_r = std::string() 
)

Set header for key_r removing all other occurrences of key_r.

Exceptions
PluginFrameExceptionIf key contains illegal chars (NL or :)
PluginFrameExceptionIf value contains illegal chars (NL)

Definition at line 320 of file PluginFrame.cc.

◆ setHeader() [2/2]

void zypp::PluginFrame::setHeader ( HeaderInitializerList  contents_r)
inline

Set a new header list.

Exceptions
PluginFrameExceptionIf key contains illegal chars (NL or :)
PluginFrameExceptionIf value contains illegal chars (NL)

Definition at line 214 of file PluginFrame.h.

◆ addHeader() [1/2]

void zypp::PluginFrame::addHeader ( const std::string &  key_r,
const std::string &  value_r = std::string() 
)

Add header for key_r leaving already existing headers for key_r unchanged.

Exceptions
PluginFrameExceptionIf key contains illegal chars (NL or :)
PluginFrameExceptionIf value contains illegal chars (NL)

Definition at line 323 of file PluginFrame.cc.

◆ addHeader() [2/2]

void zypp::PluginFrame::addHeader ( HeaderInitializerList  contents_r)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 326 of file PluginFrame.cc.

◆ clearHeader()

void zypp::PluginFrame::clearHeader ( const std::string &  key_r)

Remove all headers for key_r.

Definition at line 329 of file PluginFrame.cc.

◆ writeTo() [1/2]

std::ostream & zypp::PluginFrame::writeTo ( std::ostream &  stream_r) const

Write frame to stream.

Exceptions
PluginFrameExceptionOn error writing to stream

Definition at line 302 of file PluginFrame.cc.

◆ writeTo() [2/2]

static std::ostream& zypp::PluginFrame::writeTo ( std::ostream &  stream_r,
const PluginFrame frame_r 
)
inlinestatic

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 235 of file PluginFrame.h.

◆ readFrom() [1/2]

std::istream& zypp::PluginFrame::readFrom ( std::istream &  stream_r)
inline

Read frame from stream.

Exceptions
PluginFrameExceptionIf PluginFrame(std::istream&) throws

Definition at line 241 of file PluginFrame.h.

◆ readFrom() [2/2]

static std::istream& zypp::PluginFrame::readFrom ( std::istream &  stream_r,
PluginFrame frame_r 
)
inlinestatic

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Definition at line 245 of file PluginFrame.h.

Friends And Related Function Documentation

◆ operator<< [1/2]

std::ostream& operator<< ( std::ostream &  str,
const PluginFrame obj 
)
friend

Definition at line 334 of file PluginFrame.cc.

◆ operator== [1/2]

bool operator== ( const PluginFrame lhs,
const PluginFrame rhs 
)
friend

Definition at line 337 of file PluginFrame.cc.

◆ operator<<() [2/2]

std::ostream & operator<< ( std::ostream &  str,
const PluginFrame obj 
)
related

Stream output for logging

Definition at line 334 of file PluginFrame.cc.

◆ dumpOn()

std::ostream & dumpOn ( std::ostream &  str,
const PluginFrame obj 
)
related

Stream output writing all data for logging (no throw)

Definition at line 260 of file PluginFrame.h.

◆ operator>>()

std::istream & operator>> ( std::istream &  str,
PluginFrame obj 
)
related

Construct from stream.

Definition at line 264 of file PluginFrame.h.

◆ operator==() [2/2]

bool operator== ( const PluginFrame lhs,
const PluginFrame rhs 
)
related

Comparison based on content.

Definition at line 337 of file PluginFrame.cc.

◆ operator!=()

bool operator!= ( const PluginFrame lhs,
const PluginFrame rhs 
)
related

Comparison based on content.

Definition at line 271 of file PluginFrame.h.

Member Data Documentation

◆ _pimpl

RWCOW_pointer<Impl> zypp::PluginFrame::_pimpl
private

Pointer to implementation.

Definition at line 250 of file PluginFrame.h.


The documentation for this class was generated from the following files: