Examples of ch.agent.crnickl.api.UpdatableSchema

ch.agent.crnickl.api.UpdatableSchema
An UpdatableSchema is a schema which can be modified. A schema can only be modified if it is not in use or if the modification has no consequence on existing use. For example a series can always be added but can only be deleted if no chronicle using the schema has actually created the series.
Updatable schemas are not only used in client applications like schema editors but also by CrNiCKL internally. Any schema can be defined as an extension to another schema. Schemas are kept in permanent storage without resolving these extensions. Before a schema is made available for use, CrNiCKL resolves the extensions. Extensions are visible to clients only in edit mode.
A hypothetical example will help to illustrate how schemas are constructed. The example uses 3 schemas: a, b, and c. Schema a defines two series, s1 and s2, and one attribute, a1. Schema b extends schema a; it removes series s2, and adds series s3. Schema c extends schema b; it adds attribute a2 and redefines attribute a1 (for example with a different default value). Given this design, a chronicle with effective schema c, will have two series, s1 and s3, and two attributes, a1 and a2. It will not be aware of the existence of schemas a and b. @author Jean-Paul Vetterli @version 1.1.0

   * @param surrogate a surrogate
   * @return a schema or null
   * @throws T2DBException
   */
  public UpdatableSchema getSchema(Surrogate surrogate) throws T2DBException {
    UpdatableSchema schema = null;
    RawSchema rawSchema = getRawSchema(surrogate);
    if (rawSchema != null)
      schema = getSchema(surrogate.getDatabase(), rawSchema, null);
    return schema;
  }

View Full Code Here

   * @return an updatable schema
   * @throws T2DBException
   */
  private UpdatableSchema getSchema(Database database, RawSchema rawSchema, Set<Integer> cycleDetector) throws T2DBException {
    
    UpdatableSchema schema = null;
    if (cycleDetector == null)
      cycleDetector = new HashSet<Integer>();


    boolean cycleDetected = !cycleDetector.add(rawSchema.getId());
    
    String name = rawSchema.getName();
    UpdatableSchema base = null;
    if (rawSchema.getParent() > 0 && !cycleDetected) {
      Surrogate parentKey = makeSurrogate(database, DBObjectType.SCHEMA, rawSchema.getParent());
      RawSchema rawBaseSchema = getRawSchema(parentKey);
      if (rawBaseSchema == null)
        throw T2DBMsg.exception(E.E30116, rawSchema.getParent(), name);

View Full Code Here

    boolean nameEdited = nameEdited(schema, rawSchema);
    boolean baseEdited = baseEdited(schema, rawSchema);
    if (nameEdited || baseEdited) {
      try {
        check(Permission.MODIFY, schema);
        UpdatableSchema previousBase = ((UpdatableSchemaImpl) schema).getPreviousBase();
        if (schema.getBase() != null && !schema.getBase().equals(previousBase))
          check(Permission.READ, schema.getBase());
        update_schema = open(UPDATE_SCHEMA, schema, update_schema);
        update_schema.setString(1, name);
        update_schema.setInt(2, getIdOrZero(base));

View Full Code Here

  private boolean nameEdited(UpdatableSchema schema, RawSchema current) {
    return !schema.getName().equals(current.getName());
  }
  
  private boolean baseEdited(UpdatableSchema schema, RawSchema current) {
    UpdatableSchema base = schema.getBase();
    int editedBaseId = getIdOrZero(base);
    int currentBaseId = current.getParent();
    return editedBaseId != currentBaseId;
  }

View Full Code Here

   * @param surrogate a surrogate
   * @return a schema or null
   * @throws T2DBException
   */
  public UpdatableSchema getSchema(Surrogate surrogate) throws T2DBException {
    UpdatableSchema schema = null;
    RawSchema rawSchema = getRawSchema(surrogate);
    if (rawSchema != null)
      schema = getSchema(surrogate.getDatabase(), rawSchema, null);
    return schema;
  }

View Full Code Here

    if (cycleDetector.contains(rawSchema.getId()))
      throw T2DBJMsg.exception(J.J30115, rawSchema.getId(), cycleDetector.toString());
    cycleDetector.add(rawSchema.getId());
    UpdatableSchemaImpl schema = null;
    String name = rawSchema.getName();
    UpdatableSchema base = null;
    if (rawSchema.getParent() > 0) {
      Surrogate parentKey = makeSurrogate(database, DBObjectType.SCHEMA, rawSchema.getParent());
      RawSchema brs = getRawSchema(parentKey);
      if (brs == null)
        throw T2DBJMsg.exception(J.J30116, rawSchema.getParent(), name);

View Full Code Here

    return getReadMethodsForSchema().getSchemaSurrogateList(this, pattern);
  }


  @Override
  public UpdatableSchema getUpdatableSchema(Surrogate surrogate) throws T2DBException {
    UpdatableSchema schema = getReadMethodsForSchema().getSchema(surrogate);
    if (schema == null)
      throw T2DBMsg.exception(E.E30109, surrogate.toString());
    return schema;
  }

View Full Code Here

    return getReadMethodsForSchema().getSchemaSurrogateList(this, pattern);
  }


  @Override
  public UpdatableSchema getUpdatableSchema(Surrogate surrogate) throws T2DBException {
    UpdatableSchema schema = getReadMethodsForSchema().getSchema(surrogate);
    if (schema == null)
      throw T2DBJMsg.exception(J.J30109, surrogate.toString());
    return schema;
  }

View Full Code Here

    return schema;
  }


  @Override
  public void create(UpdatableSchema schema) throws T2DBException {
    UpdatableSchema base = schema.getBase();
    getWriteMethodsForSchema().createSchema((UpdatableSchemaImpl) schema, base);
    publish(new UpdateEventImpl(UpdateEventOperation.CREATE, schema));
  }

View Full Code Here

    return getReadMethodsForSchema().getSchemaSurrogateList(this, pattern);
  }


  @Override
  public UpdatableSchema getUpdatableSchema(Surrogate surrogate) throws T2DBException {
    UpdatableSchema schema = getReadMethodsForSchema().getSchema(surrogate);
    if (schema == null)
      throw T2DBMsg.exception(E.E30109, surrogate.toString());
    return schema;
  }

View Full Code Here

0 1 2 3 4 5 6 7 8 9

TOP

Related Classes of ch.agent.crnickl.api.UpdatableSchema

ch.agent.crnickl.impl.DatabaseBackendImpl

ch.agent.crnickl.impl.SchemaUpdatePolicyImpl

ch.agent.crnickl.impl.UpdatableSchemaImpl

ch.agent.crnickl.jdbc.JDBCDatabase

ch.agent.crnickl.jdbc.ReadMethodsForSchema

ch.agent.crnickl.jdbc.WriteMethodsForSchema

ch.agent.crnickl.junit.T015_SchemaChronicleSeriesValueTest

ch.agent.crnickl.junit.T017_SchemaTest

ch.agent.crnickl.junit.T040_SeriesTest

ch.agent.crnickl.junit.T041_UpdatableSeriesTest

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.