[SOLR-10850] HttpSolrClient Javadoc examples reference nonexistent constructors

• Type: Bug
• Status: Resolved
• Priority: Minor
• Resolution: Duplicate
• Affects Version/s: 7.0
• Fix Version/s: 7.0
• Component/s: SolrJ
• Assignee: Unassigned
• Reporter: Jason Gerlowski
• Created: 08/Jun/17 12:43
• Updated: 08/Jun/19 15:21
• Resolved: 12/Jun/17 23:15

Description

A recent JIRA removed a number of deprecated constructors from the SolrClient implementations.

In the case of HttpSolrClient, the top-level Javadocs contain instantiation instructions that still reference the old constructors:

e.g.

/**
 * A SolrClient implementation that talks directly to a Solr server via HTTP
 *
 * There are two ways to use an HttpSolrClient:
 *
 * 1) Pass a URL to the constructor that points directly at a particular core
 * <pre>
 *   SolrClient client = new HttpSolrClient("http://my-solr-server:8983/solr/core1");
 *   QueryResponse resp = client.query(new SolrQuery("*:*"));
 * </pre>
 * In this case, you can query the given core directly, but you cannot query any other
 * cores or issue CoreAdmin requests with this client.
 *
 * 2) Pass the base URL of the node to the constructor
 * <pre>
 *   SolrClient client = new HttpSolrClient("http://my-solr-server:8983/solr");
 *   QueryResponse resp = client.query("core1", new SolrQuery("*:*"));
 * </pre>
 * In this case, you must pass the name of the required core for all queries and updates,
 * but you may use the same client for all cores, and for CoreAdmin requests.
 */

These Javadocs should be updated with examples that use the client Builder types.

Issue Links

• duplicates: SOLR-10851 SolrClient's should clarify expectations for solrServerUrl parameter
• is related to: SOLR-10755 delete/refactor (most) solrj deprecations on master