apex-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "ASF GitHub Bot (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (APEXMALHAR-1897) Create ManagedState
Date Sat, 19 Mar 2016 20:50:33 GMT

    [ https://issues.apache.org/jira/browse/APEXMALHAR-1897?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15202960#comment-15202960
] 

ASF GitHub Bot commented on APEXMALHAR-1897:
--------------------------------------------

Github user ilooner commented on a diff in the pull request:

    https://github.com/apache/incubator-apex-malhar/pull/145#discussion_r56754934
  
    --- Diff: library/src/main/java/com/datatorrent/lib/state/TimeSlicedBucketedState.java
---
    @@ -0,0 +1,98 @@
    +/**
    + * Licensed to the Apache Software Foundation (ASF) under one
    + * or more contributor license agreements.  See the NOTICE file
    + * distributed with this work for additional information
    + * regarding copyright ownership.  The ASF licenses this file
    + * to you 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 com.datatorrent.lib.state;
    +
    +import java.util.concurrent.Future;
    +
    +import com.datatorrent.netlet.util.Slice;
    +
    +/**
    + * A type of bucketed state where a bucket's data is further divided into time buckets.
This requires
    + * time per key to figure out which time bucket a particular key belongs to.
    + * <p/>
    + * The time value eases purging of aged key/value pair.
    + */
    +public interface TimeSlicedBucketedState
    +{
    +  /**
    +   * Sets the value of a key in the bucket identified by bucketId. Time is used to derive
which time bucket (within
    +   * the main bucket) a key belongs to.
    +   *
    +   * @param bucketId identifier of the bucket.
    +   * @param time    time associated with the key.
    +   * @param key     key
    +   * @param value   value
    +   */
    +  void put(long bucketId, long time, Slice key, Slice value);
    +
    +  /**
    +   * Returns the value of the key in the bucket identified by bucketId. This will search
for the key in all the
    +   * time buckets.</br>
    +   *
    +   * It retrieves the value synchronously that can be expensive.<br/>
    +   * {@link #getAsync(long, Slice)} is recommended for efficient reading the value of
a key.
    +   *
    +   *
    +   * @param bucketId identifier of the bucket
    +   * @param key key
    +   * @return value of the key if found; null if the key is not found;
    +   */
    +  Slice getSync(long bucketId, Slice key);
    +
    +
    +  /**
    +   * Returns the value of key in the bucket identified by bucketId. This expects the
time value.
    +   * Time is be used to derive the time bucket (within the main bucket) to which the
key belonged and only that
    --- End diff --
    
    I think there is a type. "Time is be used to derive the time bucket" should be "Time is
used to derive the time bucket"


> Create ManagedState
> -------------------
>
>                 Key: APEXMALHAR-1897
>                 URL: https://issues.apache.org/jira/browse/APEXMALHAR-1897
>             Project: Apache Apex Malhar
>          Issue Type: Sub-task
>            Reporter: Chandni Singh
>            Assignee: Chandni Singh
>             Fix For: 3.4.0
>
>
> ManagedState is described in the document below:
> https://docs.google.com/document/d/1gRWN9ufKSZSZD0N-pthlhpC9TZ8KwJ6hJlAX6nxl5f8/edit#heading=h.z87ti1fwyt0t



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message