Mercurial > hg > graal-compiler
view graal/com.oracle.truffle.api.object/src/com/oracle/truffle/api/object/DynamicObject.java @ 19554:3be278f50e4b
Reenable usage dropped to zero listener.
author | Thomas Wuerthinger <thomas.wuerthinger@oracle.com> |
---|---|
date | Mon, 23 Feb 2015 00:29:23 +0100 |
parents | 723142fed324 |
children | 5f3dda39d205 |
line wrap: on
line source
/* * Copyright (c) 2013, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ package com.oracle.truffle.api.object; import com.oracle.truffle.api.*; import com.oracle.truffle.api.interop.*; public abstract class DynamicObject implements TypedObject, TruffleObject { /** * Get the object's current shape. */ public abstract Shape getShape(); /** * Get property value. * * @param key property identifier * @param defaultValue return value if property is not found * @return property value or defaultValue if object has no such property */ public abstract Object get(Object key, Object defaultValue); /** * Set value of existing property. * * @param key property identifier * @param value value to be set * @return {@code true} if successful or {@code false} if property not found */ public abstract boolean set(Object key, Object value); /** * Define new property or redefine existing property. * * @param key property identifier * @param value value to be set * @param flags flags to be set */ public abstract void define(Object key, Object value, int flags); /** * Define new property with a static location or change existing property. * * @param key property identifier * @param value value to be set * @param flags flags to be set * @param locationFactory factory function that creates a location for a given shape and value */ public abstract void define(Object key, Object value, int flags, LocationFactory locationFactory); /** * Change property flags. * * @param key property identifier * @param newFlags flags to be set * @return {@code true} if successful or {@code false} if property not found */ public abstract boolean changeFlags(Object key, int newFlags); /** * Change property flags. * * @param key property identifier * @param flagsUpdateFunction function updating old flags to new flags * @return {@code true} if successful or {@code false} if property not found */ public abstract boolean changeFlags(Object key, FlagsFunction flagsUpdateFunction); /** * Delete property. * * @param key property identifier * @return {@code true} if successful or {@code false} if property not found */ public abstract boolean delete(Object key); /** * Returns the number of properties in this object. */ public abstract int size(); /** * Returns {@code true} if this object contains no properties. */ public abstract boolean isEmpty(); /** * Set object shape and grow storage if necessary. * * @param oldShape the object's current shape (must equal {@link #getShape()}) * @param newShape the new shape to be set */ public abstract void setShapeAndGrow(Shape oldShape, Shape newShape); /** * Set object shape and resize storage if necessary. * * @param oldShape the object's current shape (must equal {@link #getShape()}) * @param newShape the new shape to be set */ public abstract void setShapeAndResize(Shape oldShape, Shape newShape); /** * Ensure object shape is up-to-date. * * @return {@code true} if shape has changed */ public abstract boolean updateShape(); public interface FlagsFunction { int apply(int t); } }