1 /* 2 * Copyright (c) 2021-2023 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16 #ifndef FOUNDATION_EVENT_CESFWK_INNERKITS_INCLUDE_COMMON_EVENT_STUB_H 17 #define FOUNDATION_EVENT_CESFWK_INNERKITS_INCLUDE_COMMON_EVENT_STUB_H 18 19 #include "common_event_service_ipc_interface_code.h" 20 #include "icommon_event.h" 21 #include "iremote_stub.h" 22 #include "nocopyable.h" 23 24 namespace OHOS { 25 namespace EventFwk { 26 class CommonEventStub : public IRemoteStub<ICommonEvent> { 27 public: 28 CommonEventStub(); 29 30 virtual ~CommonEventStub(); 31 32 /** 33 * Processes the remote Request. 34 * 35 * @param code Indicates the code to send. 36 * @param data Indicates the message to send. 37 * @param reply Indicates the message to reply. 38 * @param option Indicates the message option. 39 * @return Returns ERR_NONE if success, otherwise ERR_CODE. 40 */ 41 int OnRemoteRequest( 42 uint32_t code, MessageParcel &data, MessageParcel &reply, MessageOption &option) override; 43 44 /** 45 * Publishes a common event. 46 * 47 * @param event Indicates the common event data. 48 * @param publishInfo Indicates the publish info. 49 * @param commonEventListener Indicates the last subscriber to receive the event. 50 * @param userId Indicates the user ID. 51 * @return Returns ERR_OK if successful; otherwise failed. 52 */ 53 int32_t PublishCommonEvent(const CommonEventData &event, const CommonEventPublishInfo &publishinfo, 54 const sptr<IRemoteObject> &commonEventListener, const int32_t &userId) override; 55 56 /** 57 * Publishes a common event. 58 * 59 * @param event Indicates the common event data. 60 * @param publishInfo Indicates the publish info. 61 * @param commonEventListener Indicates the last subscriber to receive the event. 62 * @param uid Indicates the uid. 63 * @param callerToken Indicates the caller token. 64 * @param userId Indicates the user ID. 65 * @return Returns true if successful; false otherwise. 66 */ 67 bool PublishCommonEvent(const CommonEventData &event, const CommonEventPublishInfo &publishinfo, 68 const sptr<IRemoteObject> &commonEventListener, const uid_t &uid, const int32_t &callerToken, 69 const int32_t &userId) override; 70 71 /** 72 * Subscribes to common events. 73 * 74 * @param subscribeInfo Indicates the subscribe information. 75 * @param commonEventListener Indicates the subscriber object. 76 * @return Returns ERR_OK if successful; otherwise failed. 77 */ 78 int32_t SubscribeCommonEvent( 79 const CommonEventSubscribeInfo &subscribeInfo, const sptr<IRemoteObject> &commonEventListener) override; 80 81 /** 82 * Unsubscribes from common events. 83 * 84 * @param commonEventListener Indicates the subscriber object. 85 * @return Returns ERR_OK if successful; otherwise failed. 86 */ 87 int32_t UnsubscribeCommonEvent(const sptr<IRemoteObject> &commonEventListener) override; 88 89 /** 90 * Gets the current sticky common event. 91 * 92 * @param event Indicates the common event. 93 * @param eventData Indicates the common event data. 94 * @return Returns true if successful; false otherwise. 95 */ 96 bool GetStickyCommonEvent(const std::string &event, CommonEventData &eventData) override; 97 98 /** 99 * Dumps the state for common event service. 100 * 101 * @param dumpType Indicates the dump type. 102 * @param event Indicates the specified event. 103 * @param userId Indicates the user id. 104 * @param state Indicates the output result. 105 * @return Returns true if successful; false otherwise. 106 */ 107 bool DumpState(const uint8_t &dumpType, const std::string &event, const int32_t &userId, 108 std::vector<std::string> &state) override; 109 110 /** 111 * Finishes the receiver for the ordered common event. 112 * 113 * @param proxy Indicates the current subscriber object. 114 * @param code Indicates the result code. 115 * @param receiverData Indicates the result data. 116 * @param abortEvent Indicates whether the current ordered common event should be aborted. 117 * @return Returns true if successful; false otherwise. 118 */ 119 bool FinishReceiver(const sptr<IRemoteObject> &proxy, const int32_t &code, 120 const std::string &receiverData, const bool &abortEvent) override; 121 122 /** 123 * Freezes the specified process. 124 * 125 * @param uid Indicates the uid of frozen process. 126 * @return Returns true if successful; false otherwise. 127 */ 128 bool Freeze(const uid_t &uid) override; 129 130 /** 131 * Unfreezes the specified process. 132 * 133 * @param uid Indicates the uid of unfrozen process. 134 * @return Returns true if successful; false otherwise. 135 */ 136 bool Unfreeze(const uid_t &uid) override; 137 138 /** 139 * Unfreezes all frozen applications. 140 * 141 * @return Returns true if successful; false otherwise. 142 */ 143 bool UnfreezeAll() override; 144 145 /** 146 * Remove sticky common event. 147 * 148 * @param event Name of the common event. 149 * @return Returns ERR_OK if success; otherwise failed. 150 */ 151 int32_t RemoveStickyCommonEvent(const std::string &event) override; 152 153 /** 154 * Set Static Subscriber State. 155 * 156 * @param enable static subscriber state. 157 * @return Returns ERR_OK if success; otherwise failed. 158 */ 159 int32_t SetStaticSubscriberState(bool enable) override; 160 161 private: 162 DISALLOW_COPY_AND_MOVE(CommonEventStub); 163 }; 164 } // namespace EventFwk 165 } // namespace OHOS 166 167 #endif // FOUNDATION_EVENT_CESFWK_INNERKITS_INCLUDE_COMMON_EVENT_STUB_H 168