FIRFirestore+Internal.h 2.2 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. /*
  2. * Copyright 2017 Google
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #import "FIRFirestore.h"
  17. #import "FIRFirestoreSwiftNameSupport.h"
  18. NS_ASSUME_NONNULL_BEGIN
  19. @class FSTDatabaseID;
  20. @class FSTDispatchQueue;
  21. @class FSTFirestoreClient;
  22. @class FSTUserDataConverter;
  23. @protocol FSTCredentialsProvider;
  24. @interface FIRFirestore (/* Init */)
  25. /**
  26. * Initializes a Firestore object with all the required parameters directly. This exists so that
  27. * tests can create FIRFirestore objects without needing FIRApp.
  28. */
  29. - (instancetype)initWithProjectID:(NSString *)projectID
  30. database:(NSString *)database
  31. persistenceKey:(NSString *)persistenceKey
  32. credentialsProvider:(id<FSTCredentialsProvider>)credentialsProvider
  33. workerDispatchQueue:(FSTDispatchQueue *)workerDispatchQueue
  34. firebaseApp:(FIRApp *)app;
  35. @end
  36. /** Internal FIRFirestore API we don't want exposed in our public header files. */
  37. @interface FIRFirestore (Internal)
  38. /** Checks to see if logging is is globally enabled for the Firestore client. */
  39. + (BOOL)isLoggingEnabled;
  40. /**
  41. * Shutdown this `FIRFirestore`, releasing all resources (abandoning any outstanding writes,
  42. * removing all listens, closing all network connections, etc.).
  43. *
  44. * @param completion A block to execute once everything has shut down.
  45. */
  46. - (void)shutdownWithCompletion:(nullable void (^)(NSError *_Nullable error))completion
  47. FIR_SWIFT_NAME(shutdown(completion:));
  48. @property(nonatomic, strong, readonly) FSTDatabaseID *databaseID;
  49. @property(nonatomic, strong, readonly) FSTFirestoreClient *client;
  50. @property(nonatomic, strong, readonly) FSTUserDataConverter *dataConverter;
  51. @end
  52. NS_ASSUME_NONNULL_END