X-Git-Url: https://gerrit.simantics.org/r/gitweb?a=blobdiff_plain;ds=sidebyside;f=bundles%2Forg.simantics.ui%2Fsrc%2Forg%2Fsimantics%2Fui%2Fworkbench%2FResourceInput.java;fp=bundles%2Forg.simantics.ui%2Fsrc%2Forg%2Fsimantics%2Fui%2Fworkbench%2FResourceInput.java;h=20399c6f3587f38efcb8cc51cb1dd31767eb9019;hb=969bd23cab98a79ca9101af33334000879fb60c5;hp=0000000000000000000000000000000000000000;hpb=866dba5cd5a3929bbeae85991796acb212338a08;p=simantics%2Fplatform.git diff --git a/bundles/org.simantics.ui/src/org/simantics/ui/workbench/ResourceInput.java b/bundles/org.simantics.ui/src/org/simantics/ui/workbench/ResourceInput.java new file mode 100644 index 000000000..20399c6f3 --- /dev/null +++ b/bundles/org.simantics.ui/src/org/simantics/ui/workbench/ResourceInput.java @@ -0,0 +1,178 @@ +/******************************************************************************* + * Copyright (c) 2007, 2010 Association for Decentralized Information Management + * in Industry THTH ry. + * 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: + * VTT Technical Research Centre of Finland - initial API and implementation + *******************************************************************************/ +package org.simantics.ui.workbench; + +import org.simantics.db.Resource; +import org.simantics.db.Session; +import org.simantics.db.common.request.Queries; +import org.simantics.db.exception.DatabaseException; + + +/** + * A wrapper class for parsing and generating the information given to Simantics + * views as a parameter through view secondary ID's. + * + *
+ * To parse the input data (given in the secondary ID) just invoke:
+ * new ResourceInput(secondaryIdString)
+ *
+ * To generate a secondary ID string based an input resource ID, invoke:
+ * new ResourceInput(inputResourceId).marshall()
+ *
null
to ignore the unique suffix
+ */
+ public ResourceInput(String randomAccessResourceId, String uniqueSuffix) {
+ this.inputResourceId = randomAccessResourceId;
+ this.suffix = (uniqueSuffix == null) ? EMPTY_SUFFIX : uniqueSuffix;
+ }
+
+ /**
+ * Returns a new ResourceInput instance with the specified ID as
+ * input. This method exists in order to make sure that the client can get a
+ * clone of the original ResourceInput in every way except for the
+ * input ID in a unified fashion.
+ *
+ * @param newInputResourceId the new input resource ID
+ * @return new ResourceInput instance with the specified input resource ID
+ */
+ public ResourceInput changeInput(String newRandomAccessResourceId) {
+ if (suffix == EMPTY_SUFFIX)
+ return new ResourceInput(newRandomAccessResourceId);
+ return new ResourceInput(newRandomAccessResourceId, suffix);
+ }
+
+ public String getInputResourceId() {
+ return inputResourceId;
+ }
+
+ public String getSuffix() {
+ return suffix;
+ }
+
+ @Override
+ public String toString() {
+ return marshall();
+ }
+
+ /**
+ * @param session the Session to use for initiating the
+ * transaction for retrieving the input Resource.
+ * @return null
if the random access reference of this
+ * ResourceInput is invalid.
+ */
+ public Resource toResource(Session session) throws DatabaseException {
+ return session.syncRequest(Queries.resource(inputResourceId));
+ }
+
+ /**
+ * @param input Input format:
+ * client-id#input-resource-id[#unique-suffix]
+ * @throws IllegalArgumentException if input is invalid
+ */
+ public String marshall() {
+ return String.format("%s@%s", inputResourceId, suffix);
+ }
+
+ /**
+ * @param a previously marshalled ResourceInput using
+ * {@link #marshall()}
+ * @throws IllegalArgumentException if input is invalid
+ */
+ public static ResourceInput unmarshall(String input) throws IllegalArgumentException {
+ if (input == null)
+ throw new IllegalArgumentException("null input");
+ String[] parts = input.split(SUFFIX_SEPARATOR);
+ if (parts.length < 1)
+ throw new IllegalArgumentException("invalid input: " + input);
+
+ // Get input resource random access id
+ String id = parts[0];
+
+ // Get arbitrary suffix
+ String suffix = EMPTY_SUFFIX;
+ if (parts.length > 1) {
+ suffix = input.substring(id.length() + 1);
+ }
+ return new ResourceInput(id, suffix);
+ }
+
+ public static Resource unmarshallToResource(String input, Session session) throws DatabaseException {
+ ResourceInput in = unmarshall(input);
+ return in.toResource(session);
+ }
+
+ @Override
+ public int hashCode() {
+ final int prime = 31;
+ int result = 1;
+ result = prime * result + ((inputResourceId == null) ? 0 : inputResourceId.hashCode());
+ result = prime * result + ((suffix == null) ? 0 : suffix.hashCode());
+ return result;
+ }
+
+ @Override
+ public boolean equals(Object obj) {
+ if (this == obj)
+ return true;
+ if (obj == null)
+ return false;
+ if (getClass() != obj.getClass())
+ return false;
+ final ResourceInput other = (ResourceInput) obj;
+ if (inputResourceId == null) {
+ if (other.inputResourceId != null)
+ return false;
+ } else if (!inputResourceId.equals(other.inputResourceId))
+ return false;
+ if (suffix == null) {
+ if (other.suffix != null)
+ return false;
+ } else if (!suffix.equals(other.suffix))
+ return false;
+ return true;
+ }
+
+}