PLCnext API Documentation  21.6.0.46
ISubscriptionService.hpp
1 //
3 // Copyright PHOENIX CONTACT Electronics GmbH
4 //
6 #pragma once
7 #include "Arp/System/Core/Arp.h"
8 #include "Arp/System/Rsc/Services/IRscService.hpp"
9 #include "SubscriptionServiceProxyFactory.hpp"
10 #include "Arp/System/Core/delegate.hxx"
11 #include "Arp/System/Rsc/Services/IRscReadEnumerator.hxx"
12 #include "Arp/System/Rsc/Services/IRscWriteEnumerator.hxx"
13 #include "Arp/System/Rsc/Services/RscString.hxx"
14 #include "Arp/System/Rsc/Services/RscVariant.hxx"
15 #include "DataAccessError.hpp"
16 #include "SubscriptionKind.hpp"
17 #include "VariableInfo.hpp"
18 
19 // DO NOT MODIFY THIS FILE, THIS FILE IS AUTOGENERATED BY ISubscriptionService.cs
20 
21 namespace Arp { namespace Plc { namespace Gds { namespace Services
22 {
23 
24 using namespace Arp;
25 using namespace Arp::System::Rsc::Services;
26 
86 {
87 public: // typedefs
88  using Ptr = std::shared_ptr<ISubscriptionService>;
89  using AddVariablesVariableNamesDelegate = delegate<void(IRscWriteEnumerator<RscString<512>>&)>;
90  using AddVariablesResultDelegate = delegate<void(IRscReadEnumerator<DataAccessError>&)>;
91  using GetVariableInfosVariableInfoDelegate = delegate<void(IRscReadEnumerator<VariableInfo>&)>;
92  using GetTimeStampedVariableInfosVariableInfoDelegate = delegate<void(IRscReadEnumerator<VariableInfo>&)>;
93  using GetRecordInfosRecordInfosDelegate = delegate<void(IRscReadEnumerator<VariableInfo>&)>;
94  using ReadValuesValuesDelegate = delegate<void(IRscReadEnumerator<RscVariant<512>>&)>;
95  using ReadTimeStampedValuesValuesDelegate = delegate<void(IRscReadEnumerator<RscVariant<512>>&)>;
96  using ReadRecordsRecordsDelegate = delegate<void(IRscReadEnumerator<RscVariant<512>>&)>;
97 
98 public: // construction/destruction
100  ISubscriptionService(void) = default;
101 
102 public: // static policy operation
103  static IRscServiceProxyFactory& GetProxyFactory(void);
104 
105 public: // abstract operations
209  virtual uint32 CreateSubscription(SubscriptionKind kind) = 0;
210 
227  virtual uint32 CreateRecordingSubscription(uint16 recordCount) = 0;
228 
279  virtual DataAccessError AddVariable(uint32 subscriptionId, const RscString<512>& variableName) = 0;
280 
300  virtual void AddVariables(uint32 subscriptionId, AddVariablesVariableNamesDelegate variableNamesDelegate, AddVariablesResultDelegate resultDelegate) = 0;
301 
320  virtual DataAccessError RemoveVariable(uint32 subscriptionId, const RscString<512>& variableName) = 0;
321 
389  virtual DataAccessError Subscribe(uint32 subscriptionId, uint64 sampleRate) = 0;
390 
419  virtual DataAccessError Resubscribe(uint32 subscriptionId, uint64 sampleRate) = 0;
420 
441  virtual DataAccessError Unsubscribe(uint32 subscriptionId) = 0;
442 
456  virtual DataAccessError DeleteSubscription(uint32 subscriptionId) = 0;
457 
508  virtual DataAccessError GetVariableInfos(uint32 subscriptionId, GetVariableInfosVariableInfoDelegate variableInfoDelegate) = 0;
509 
557  virtual DataAccessError GetTimeStampedVariableInfos(uint32 subscriptionId, GetTimeStampedVariableInfosVariableInfoDelegate variableInfoDelegate) = 0;
558 
614  virtual DataAccessError GetRecordInfos(uint32 subscriptionId, GetRecordInfosRecordInfosDelegate recordInfosDelegate) = 0;
615 
663  virtual DataAccessError ReadValues(uint32 subscriptionId, ReadValuesValuesDelegate valuesDelegate) = 0;
664 
710  virtual DataAccessError ReadTimeStampedValues(uint32 subscriptionId, ReadTimeStampedValuesValuesDelegate valuesDelegate) = 0;
711 
789  virtual DataAccessError ReadRecords(uint32 subscriptionId, uint16 count, ReadRecordsRecordsDelegate recordsDelegate) = 0;
790 };
791 
793 // inline methods of class ISubscriptionService
794 inline IRscServiceProxyFactory& ISubscriptionService::GetProxyFactory()
795 {
796  return SubscriptionServiceProxyFactory::GetInstance();
797 }
798 
799 }}}} // end of namespace Arp::Plc::Gds::Services
Namespace for classes and interfaces for the Remote Service Call implementation
Definition: IRscReadEnumerator.hxx:9
std::uint32_t uint32
The Arp unsigned integer type of 4 byte size.
Definition: PrimitiveTypes.hpp:35
Services for the subscription.
Definition: ISubscriptionService.hpp:85
DataAccessError
This enumeration contains the possible data access errors.
Definition: DataAccessError.hpp:20
Root namespace for the PLCnext API
std::uint16_t uint16
The Arp unsigned integer type of 2 byte size.
Definition: PrimitiveTypes.hpp:31
std::uint64_t uint64
The Arp unsigned integer type of 8 byte size.
Definition: PrimitiveTypes.hpp:39
Base interface for all Rsc service interface.
Definition: IRscService.hpp:18
SubscriptionKind
This enumeration contains the possible kinds of subscriptions.
Definition: SubscriptionKind.hpp:29