MediaAccess.h

Go to the documentation of this file.

/*---------------------------------------------------------------------\
|                                                                      |
|                      __   __    ____ _____ ____                      |
|                      \ \ / /_ _/ ___|_   _|___ \                     |
|                       \ V / _` \___ \ | |   __) |                    |
|                        | | (_| |___) || |  / __/                     |
|                        |_|\__,_|____/ |_| |_____|                    |
|                                                                      |
|                               core system                            |
|                                                        (C) SuSE GmbH |
\----------------------------------------------------------------------/

   File:        MediaAccess.h

   Author:      Klaus Kaempf <kkaempf@suse.de>
   Maintainer:  Klaus Kaempf <kkaempf@suse.de>

   Purpose:     Handle access to a medium

/-*/
#ifndef MediaAccess_h
#define MediaAccess_h

#include <iosfwd>
#include <map>
#include <list>
#include <string>

#include <y2util/Pathname.h>
#include <y2util/PathInfo.h>
#include <y2util/Url.h>

#include <y2pm/MediaAccessPtr.h>
#include <y2pm/MediaError.h>

class MediaHandler;

//
//      CLASS NAME : MediaAccess
class MediaAccess : public CountedRep {
        REP_BODY(MediaAccess);

    public:

        typedef MediaError Error;

    private:

        static const Pathname _noPath;

        MediaHandler * _handler;

    public:

        MediaAccess();

        PMError open( const Url& url, const Pathname & preferred_attach_point = "" );

        bool isOpen() const { return( _handler != 0 ); }

        Url::Protocol protocol() const;

        Url url() const;

        PMError close();

    public:

        PMError attach(bool next = false);

        bool isAttached() const;

        const Pathname & localRoot() const;

        Pathname localPath( const Pathname & pathname ) const;

        PMError disconnect();

        PMError release( bool eject = false );

        PMError provideFile( const Pathname & filename, bool cached = false, bool checkonly = false ) const;

        PMError releaseFile( const Pathname & filename ) const;

        PMError provideDir( const Pathname & dirname ) const;

        PMError provideDirTree( const Pathname & dirname ) const;

        PMError releaseDir( const Pathname & dirname ) const;

        PMError releasePath( const Pathname & pathname ) const;

    public:

        PMError dirInfo( std::list<std::string> & retlist,
                         const Pathname & dirname, bool dots = true ) const;

        PMError dirInfo( PathInfo::dircontent & retlist,
                         const Pathname & dirname, bool dots = true ) const;

        virtual ~MediaAccess();

    public:

        virtual std::ostream & dumpOn( std::ostream & str ) const;

    public:
        static PMError getFile( const Url &from, const Pathname &to );

    public:

      class FileProvider {
        FileProvider( const FileProvider & );             // no copy
        FileProvider & operator=( const FileProvider & ); // no assign
        private:
          constMediaAccessPtr _media;
          Pathname            _file;
          PMError             _lasterr;
        public:
          typedef MediaError Error;

          FileProvider( constMediaAccessPtr media_r, const Pathname & file_r )
            : _media( media_r )
            , _file( file_r )
            , _lasterr( Error::E_error )
          {
            if ( _file.empty() ) {
              _lasterr = Error::E_bad_filename;
            } else if ( _media ) {
              _lasterr = _media->provideFile( _file );
            }
            if ( _lasterr )
              _media = 0;
          }

          ~FileProvider() {
            if ( _media )
              _media->releaseFile( _file );
          }

        public:

          PMError error() const { return _lasterr; }

          Pathname operator()() const {
            if ( _media )
              return _media->localPath( _file );
            return Pathname();
          }
      };
};


#endif // MediaAccess_h

---