Add deprecation in Document of embeddings and content formatter

Author: markpollack

models/spring-ai-bedrock/src/main/java/org/springframework/ai/bedrock/cohere/BedrockCohereEmbeddingModel.java

@@ -95,13 +95,14 @@ public EmbeddingResponse call(EmbeddingRequest request) {
 
 			// Handle truncation based on option
 			return switch (optionsToUse.getTruncate()) {
-				case END -> text.substring(0, COHERE_MAX_CHARACTERS); // Keep first 2048 chars
+				case END -> text.substring(0, COHERE_MAX_CHARACTERS); // Keep first 2048
+																		// chars
 				case START -> text.substring(text.length() - COHERE_MAX_CHARACTERS); // Keep
-																					// last
-																					// 2048
-																					// chars
+																						// last
+																						// 2048
+																						// chars
 				default -> text.substring(0, COHERE_MAX_CHARACTERS); // Default to END
-																	// behavior
+																		// behavior
 			};
 		}).collect(Collectors.toList());
 

spring-ai-core/src/main/java/org/springframework/ai/document/Document.java

@@ -149,6 +149,13 @@ public Map<String, Object> getMetadata() {
 		return this.metadata;
 	}
 
+	/**
+	 * Return the embedding that were calculated.
+	 * @deprecated We are considering getting rid of this, please comment on
+	 * https://github.com/spring-projects/spring-ai/issues/1781
+	 * @return the embeddings
+	 */
+	@Deprecated(since = "1.0.0-M4")
 	public float[] getEmbedding() {
 		return this.embedding;
 	}
@@ -158,6 +165,13 @@ public void setEmbedding(float[] embedding) {
 		this.embedding = embedding;
 	}
 
+	/**
+	 * Returns the content formatter associated with this document.
+	 * @deprecated We are considering getting rid of this, please comment on
+	 * https://github.com/spring-projects/spring-ai/issues/1782
+	 * @return the current ContentFormatter instance used for formatting the document
+	 * content.
+	 */
 	public ContentFormatter getContentFormatter() {
 		return this.contentFormatter;
 	}