[TTS] Add a Java Context linked to existing native

chrome/browser/android/contextualsearch/contextual_search_context.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_ANDROID_CONTEXTUALSEARCH_CONTEXTUAL_SEARCH_CONTEXT_H_
 #define CHROME_BROWSER_ANDROID_CONTEXTUALSEARCH_CONTEXTUAL_SEARCH_CONTEXT_H_
 
 #include <string>
 
+#include "base/android/jni_android.h"
 #include "base/macros.h"
 #include "url/gurl.h"
 
 // Encapsulates key parts of a Contextual Search Context, including surrounding
 // text.
 struct ContextualSearchContext {
  public:
-  ContextualSearchContext(const std::string& selected_text,
-                          const std::string& home_country,
-                          const GURL& page_url,
-                          const std::string& encoding);
+  ContextualSearchContext(JNIEnv* env, jobject obj);
+  // Constructor for tests.
+  ContextualSearchContext();
   ~ContextualSearchContext();
 
-  const std::string selected_text;
-  const std::string home_country;
-  const GURL page_url;
-  const std::string encoding;
+  // Calls the destructor.  Should be called when this native object is no
+  // longer needed.
+  void Destroy(JNIEnv* env, const base::android::JavaParamRef<jobject>& obj);
 
+  // Returns the native |ContextualSearchContext| given the java object.
+  static ContextualSearchContext* FromJavaContextualSearchContext(
+      const base::android::JavaRef<jobject>& j_contextual_search_context);
+
+  // Returns whether the content associated with this context is brief.
+  // If not, then this context may be resolved, but not otherwise.
+  bool IsBrief();
+
+  // Returns whether the base page URL may be sent (according to the Java
+  // context).
+  bool MaySendBasePageUrl();
+
+  // Sets whether the content associated with this context is brief or not.
+  void SetUseBriefPageContent(JNIEnv* env,

[Theresa, 2017/03/08 01:54:38]

Can this be combined with setProperties?

[Donn Denman, 2017/03/09 17:35:05]

Done.

Changed the model from brief/normal context to a resolvable/not-resolvable
context, which caused a few name changes for clarity.

+                              jobject obj,
+                              jboolean j_use_brief_page_content);
+
+  // Sets most of the properties on a context.
+  void SetProperties(JNIEnv* env,
+                     jobject obj,
+                     const base::android::JavaParamRef<jstring>& j_selection,
+                     const base::android::JavaParamRef<jstring>& j_home_country,
+                     jboolean j_may_send_base_page_url);
+
+  // Sets most of the properties in a way that's convenient for tests.
+  void SetPropertiesInternal(std::string selection,
+                             std::string home_country,
+                             bool may_send_base_page_url);
+
+  // Data.  TODO(donnd): make private?
+  std::string selected_text;
+  std::string home_country;
+  GURL page_url;
+  std::string encoding;
   base::string16 surrounding_text;
   int start_offset;
   int end_offset;
 
+ private:
+  bool is_brief_surrounding_text;
+  bool may_send_base_page_url;
+
+  // The linked Java object.
+  base::android::ScopedJavaGlobalRef<jobject> java_object_;
+
   DISALLOW_COPY_AND_ASSIGN(ContextualSearchContext);
 };
 
+bool RegisterContextualSearchContext(JNIEnv* env);
+
 #endif  // CHROME_BROWSER_ANDROID_CONTEXTUALSEARCH_CONTEXTUAL_SEARCH_CONTEXT_H_