/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ /** * The definitions of nsNavHistoryQuery and nsNavHistoryQueryOptions. This * header file should only be included from nsNavHistory.h, include that if * you want these classes. */ #ifndef nsNavHistoryQuery_h_ #define nsNavHistoryQuery_h_ // nsNavHistoryQuery // // This class encapsulates the parameters for basic history queries for // building UI, trees, lists, etc. #include "mozilla/Attributes.h" #define NS_NAVHISTORYQUERY_IID \ { 0xb10185e0, 0x86eb, 0x4612, { 0x95, 0x7c, 0x09, 0x34, 0xf2, 0xb1, 0xce, 0xd7 } } class nsNavHistoryQuery final : public nsINavHistoryQuery { public: nsNavHistoryQuery(); // note: we use a copy constructor in Clone(), the default is good enough NS_DECLARE_STATIC_IID_ACCESSOR(NS_NAVHISTORYQUERY_IID) NS_DECL_ISUPPORTS NS_DECL_NSINAVHISTORYQUERY int32_t MinVisits() { return mMinVisits; } int32_t MaxVisits() { return mMaxVisits; } PRTime BeginTime() { return mBeginTime; } uint32_t BeginTimeReference() { return mBeginTimeReference; } PRTime EndTime() { return mEndTime; } uint32_t EndTimeReference() { return mEndTimeReference; } const nsString& SearchTerms() { return mSearchTerms; } bool OnlyBookmarked() { return mOnlyBookmarked; } bool DomainIsHost() { return mDomainIsHost; } const nsCString& Domain() { return mDomain; } bool UriIsPrefix() { return mUriIsPrefix; } nsIURI* Uri() { return mUri; } // NOT AddRef-ed! bool AnnotationIsNot() { return mAnnotationIsNot; } const nsCString& Annotation() { return mAnnotation; } const nsTArray& Folders() const { return mFolders; } const nsTArray& Tags() const { return mTags; } nsresult SetTags(const nsTArray& aTags) { if (!mTags.ReplaceElementsAt(0, mTags.Length(), aTags)) return NS_ERROR_OUT_OF_MEMORY; return NS_OK; } bool TagsAreNot() { return mTagsAreNot; } const nsTArray& Transitions() const { return mTransitions; } nsresult SetTransitions(const nsTArray& aTransitions) { if (!mTransitions.ReplaceElementsAt(0, mTransitions.Length(), aTransitions)) return NS_ERROR_OUT_OF_MEMORY; return NS_OK; } private: ~nsNavHistoryQuery() {} protected: int32_t mMinVisits; int32_t mMaxVisits; PRTime mBeginTime; uint32_t mBeginTimeReference; PRTime mEndTime; uint32_t mEndTimeReference; nsString mSearchTerms; bool mOnlyBookmarked; bool mDomainIsHost; nsCString mDomain; // Default is IsVoid, empty string is valid query bool mUriIsPrefix; nsCOMPtr mUri; bool mAnnotationIsNot; nsCString mAnnotation; nsTArray mFolders; nsTArray mTags; bool mTagsAreNot; nsTArray mTransitions; }; NS_DEFINE_STATIC_IID_ACCESSOR(nsNavHistoryQuery, NS_NAVHISTORYQUERY_IID) // nsNavHistoryQueryOptions #define NS_NAVHISTORYQUERYOPTIONS_IID \ {0x95f8ba3b, 0xd681, 0x4d89, {0xab, 0xd1, 0xfd, 0xae, 0xf2, 0xa3, 0xde, 0x18}} class nsNavHistoryQueryOptions final : public nsINavHistoryQueryOptions { public: nsNavHistoryQueryOptions() : mSort(0) , mResultType(0) , mExcludeItems(false) , mExcludeQueries(false) , mExcludeReadOnlyFolders(false) , mExpandQueries(true) , mIncludeHidden(false) , mMaxResults(0) , mQueryType(nsINavHistoryQueryOptions::QUERY_TYPE_HISTORY) , mAsyncEnabled(false) { } NS_DECLARE_STATIC_IID_ACCESSOR(NS_NAVHISTORYQUERYOPTIONS_IID) NS_DECL_ISUPPORTS NS_DECL_NSINAVHISTORYQUERYOPTIONS uint16_t SortingMode() const { return mSort; } uint16_t ResultType() const { return mResultType; } bool ExcludeItems() const { return mExcludeItems; } bool ExcludeQueries() const { return mExcludeQueries; } bool ExcludeReadOnlyFolders() const { return mExcludeReadOnlyFolders; } bool ExpandQueries() const { return mExpandQueries; } bool IncludeHidden() const { return mIncludeHidden; } uint32_t MaxResults() const { return mMaxResults; } uint16_t QueryType() const { return mQueryType; } bool AsyncEnabled() const { return mAsyncEnabled; } nsresult Clone(nsNavHistoryQueryOptions **aResult); private: ~nsNavHistoryQueryOptions() {} nsNavHistoryQueryOptions(const nsNavHistoryQueryOptions& other) {} // no copy // IF YOU ADD MORE ITEMS: // * Add a new getter for C++ above if it makes sense // * Add to the serialization code (see nsNavHistory::QueriesToQueryString()) // * Add to the deserialization code (see nsNavHistory::QueryStringToQueries) // * Add to the nsNavHistoryQueryOptions::Clone() function // * Add to the nsNavHistory.cpp::GetSimpleBookmarksQueryFolder function if applicable uint16_t mSort; nsCString mSortingAnnotation; nsCString mParentAnnotationToExclude; uint16_t mResultType; bool mExcludeItems; bool mExcludeQueries; bool mExcludeReadOnlyFolders; bool mExpandQueries; bool mIncludeHidden; uint32_t mMaxResults; uint16_t mQueryType; bool mAsyncEnabled; }; NS_DEFINE_STATIC_IID_ACCESSOR(nsNavHistoryQueryOptions, NS_NAVHISTORYQUERYOPTIONS_IID) #endif // nsNavHistoryQuery_h_