| /******************************************************************************* |
| * Copyright (c) 2009 Cloudsmith Inc. and others. |
| * All rights reserved. This program and the accompanying materials |
| * are made available under the terms of the Eclipse Public License v1.0 |
| * which accompanies this distribution, and is available at |
| * http://www.eclipse.org/legal/epl-v10.html |
| * |
| * Contributors: |
| * Cloudsmith Inc. - initial API and implementation |
| *******************************************************************************/ |
| package org.eclipse.equinox.p2.metadata; |
| |
| /** |
| * <p>The IVersionFormat represents the Omni Version Format in compiled form. It |
| * is also a parser for versions of that format.</p> |
| * <p>An instance of IVersionFormat is immutable and thus thread safe. The parser |
| * does not maintain any state.</p> |
| * @since 2.0 |
| */ |
| public interface IVersionFormat { |
| |
| /** |
| * The string that by default will be interpreted as the logical max string when parsing |
| * optional elements of type string and a default that is the empty string (i.e. OSGi) |
| */ |
| static final String DEFAULT_MAX_STRING_TRANSLATION = "zzz"; //$NON-NLS-1$ |
| |
| /** |
| * The string that by default will be interpreted as the logical min string when parsing |
| * optional elements of type string and a default that is the max string (i.e. Maven triplets) |
| */ |
| static final String DEFAULT_MIN_STRING_TRANSLATION = "-"; //$NON-NLS-1$ |
| |
| /** |
| * Appends the string representation of this compiled format to |
| * the given StringBuffer. |
| * @param sb The buffer that will receive the string representation |
| */ |
| void toString(StringBuffer sb); |
| |
| /** |
| * Parse the given version string. |
| * @param version The version string to parse. |
| * @return A created version. |
| * @throws IllegalArgumentException If the version string could not be parsed. |
| */ |
| Version parse(String version); |
| } |