/** * Copyright 2010 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * */ package org.waveprotocol.box.common; import com.google.common.collect.Lists; import org.waveprotocol.wave.model.document.operation.AnnotationBoundaryMap; import org.waveprotocol.wave.model.document.operation.Attributes; import org.waveprotocol.wave.model.document.operation.AttributesUpdate; import org.waveprotocol.wave.model.document.operation.DocInitializationCursor; import org.waveprotocol.wave.model.document.operation.DocOp; import org.waveprotocol.wave.model.document.operation.DocOpCursor; import org.waveprotocol.wave.model.document.operation.impl.InitializationCursorAdapter; import org.waveprotocol.wave.model.wave.data.ReadableBlipData; import org.waveprotocol.wave.model.wave.data.ReadableWaveletData; import org.waveprotocol.wave.model.wave.data.WaveletData; import java.util.ArrayList; import java.util.Arrays; import java.util.List; import java.util.Set; /** * Utility methods for rendering snippets. * * @author anorth@google.com (Alex North) */ public final class Snippets { /** * Concatenates all of the text for the given documents in * {@link WaveletData}. * * @param wavelet the wavelet for which to concatenate the documents. * @return A String containing the characters from all documents. */ public static String collateTextForWavelet(ReadableWaveletData wavelet) { List<ReadableBlipData> documents = new ArrayList<ReadableBlipData>(); for (String documentId : wavelet.getDocumentIds()) { documents.add(wavelet.getDocument(documentId)); } return collateTextForDocuments(documents); } /** * Concatenates all of the text of the specified blips into a single String. * * @param documents the documents to concatenate. * @return A String containing the characters from all documents. */ public static String collateTextForDocuments(Iterable<? extends ReadableBlipData> documents) { ArrayList<DocOp> docOps = new ArrayList<DocOp>(); for (ReadableBlipData blipData : documents) { docOps.add(blipData.getContent().asOperation()); } return collateTextForOps(docOps); } /** * Concatenates all of the text of the specified docops into a single String. * * @param documentops the document operations to concatenate. * @return A String containing the characters from the operations. */ public static String collateTextForOps(Iterable<DocOp> documentops) { final StringBuilder resultBuilder = new StringBuilder(); for (DocOp docOp : documentops) { docOp.apply(InitializationCursorAdapter.adapt(new DocOpCursor() { @Override public void characters(String s) { resultBuilder.append(s); } @Override public void annotationBoundary(AnnotationBoundaryMap map) { } @Override public void elementStart(String type, Attributes attrs) { if (type.equals(DocumentConstants.LINE)) { resultBuilder.append(" "); } } @Override public void elementEnd() { } @Override public void retain(int itemCount) { } @Override public void deleteCharacters(String chars) { } @Override public void deleteElementStart(String type, Attributes attrs) { } @Override public void deleteElementEnd() { } @Override public void replaceAttributes(Attributes oldAttrs, Attributes newAttrs) { } @Override public void updateAttributes(AttributesUpdate attrUpdate) { } })); } return resultBuilder.toString().trim(); } /** * Returns a snippet or null. */ public static String renderSnippet(final ReadableWaveletData wavelet, final int maxSnippetLength) { final StringBuilder sb = new StringBuilder(); Set<String> docsIds = wavelet.getDocumentIds(); long newestLmt = -1; ReadableBlipData newestBlip = null; for (String docId : docsIds) { ReadableBlipData blip = wavelet.getDocument(docId); long currentLmt = blip.getLastModifiedTime(); if (currentLmt > newestLmt) { newestLmt = currentLmt; newestBlip = blip; } } if (newestBlip == null) { // Render whatever data we have and hope its good enough sb.append(collateTextForWavelet(wavelet)); } else { DocOp docOp = newestBlip.getContent().asOperation(); sb.append(collateTextForOps(Lists.newArrayList(docOp))); sb.append(" "); docOp.apply(InitializationCursorAdapter.adapt(new DocInitializationCursor() { @Override public void annotationBoundary(AnnotationBoundaryMap map) { } @Override public void characters(String chars) { // No chars in the conversation manifest } @Override public void elementEnd() { } @Override public void elementStart(String type, Attributes attrs) { if (sb.length() >= maxSnippetLength) { return; } if (DocumentConstants.BLIP.equals(type)) { String blipId = attrs.get(DocumentConstants.BLIP_ID); if (blipId != null) { ReadableBlipData document = wavelet.getDocument(blipId); if (document == null) { // We see this when a blip has been deleted return; } sb.append(collateTextForDocuments(Arrays.asList(document))); sb.append(" "); } } } })); } if (sb.length() > maxSnippetLength) { return sb.substring(0, maxSnippetLength); } return sb.toString(); } private Snippets() { } }