xref: /aosp_15_r20/art/runtime/mirror/field.h (revision 795d594fd825385562da6b089ea9b2033f3abf5a)

/*
 * Copyright (C) 2015 The Android Open Source Project
 *
 * Licensed 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.
 */

#ifndef ART_RUNTIME_MIRROR_FIELD_H_
#define ART_RUNTIME_MIRROR_FIELD_H_

#include "accessible_object.h"
#include "base/macros.h"
#include "base/pointer_size.h"
#include "dex/modifiers.h"
#include "dex/primitive.h"
#include "obj_ptr.h"
#include "object.h"
#include "read_barrier_option.h"

namespace art HIDDEN {

class ArtField;
struct FieldOffsets;
class ReflectiveValueVisitor;

namespace mirror {

class Class;
class String;

// C++ mirror of java.lang.reflect.Field.
class MANAGED Field : public AccessibleObject {
 public:
  MIRROR_CLASS("Ljava/lang/reflect/Field;");

  ALWAYS_INLINE uint32_t GetArtFieldIndex() REQUIRES_SHARED(Locks::mutator_lock_) {
    return GetField32(OFFSET_OF_OBJECT_MEMBER(Field, art_field_index_));
  }

  ObjPtr<mirror::Class> GetDeclaringClass() REQUIRES_SHARED(Locks::mutator_lock_);

  uint32_t GetAccessFlags() REQUIRES_SHARED(Locks::mutator_lock_) {
    return GetField32(OFFSET_OF_OBJECT_MEMBER(Field, access_flags_));
  }

  bool IsStatic() REQUIRES_SHARED(Locks::mutator_lock_) {
    return (GetAccessFlags() & kAccStatic) != 0;
  }

  bool IsFinal() REQUIRES_SHARED(Locks::mutator_lock_) {
    return (GetAccessFlags() & kAccFinal) != 0;
  }

  bool IsVolatile() REQUIRES_SHARED(Locks::mutator_lock_) {
    return (GetAccessFlags() & kAccVolatile) != 0;
  }

  ALWAYS_INLINE Primitive::Type GetTypeAsPrimitiveType() REQUIRES_SHARED(Locks::mutator_lock_);

  ObjPtr<mirror::Class> GetType() REQUIRES_SHARED(Locks::mutator_lock_);

  int32_t GetOffset() REQUIRES_SHARED(Locks::mutator_lock_) {
    return GetField32(OFFSET_OF_OBJECT_MEMBER(Field, offset_));
  }

  ArtField* GetArtField() REQUIRES_SHARED(Locks::mutator_lock_);

  static ObjPtr<mirror::Field> CreateFromArtField(Thread* self,
                                                  ArtField* field,
                                                  bool force_resolve)
      REQUIRES_SHARED(Locks::mutator_lock_) REQUIRES(!Roles::uninterruptible_);


  // Used to modify the target of this Field object, if required for structural redefinition or some
  // other purpose.
  void VisitTarget(ReflectiveValueVisitor* v) REQUIRES(Locks::mutator_lock_);

 private:
  // Padding required for matching alignment with the Java peer.
  uint8_t padding_[3];

  HeapReference<mirror::Class> declaring_class_;
  HeapReference<mirror::Class> type_;
  int32_t access_flags_;
  int32_t art_field_index_;
  int32_t offset_;

  static constexpr MemberOffset DeclaringClassOffset() {
    return OFFSET_OF_OBJECT_MEMBER(Field, declaring_class_);
  }

  static constexpr MemberOffset TypeOffset() {
    return OFFSET_OF_OBJECT_MEMBER(Field, type_);
  }

  static constexpr MemberOffset AccessFlagsOffset() {
    return OFFSET_OF_OBJECT_MEMBER(Field, access_flags_);
  }

  static constexpr MemberOffset ArtFieldIndexOffset() {
    return OFFSET_OF_OBJECT_MEMBER(Field, art_field_index_);
  }

  static constexpr MemberOffset OffsetOffset() {
    return OFFSET_OF_OBJECT_MEMBER(Field, offset_);
  }

  template<bool kTransactionActive, bool kCheckTransaction = true>
  void SetDeclaringClass(ObjPtr<Class> c) REQUIRES_SHARED(Locks::mutator_lock_);

  template<bool kTransactionActive, bool kCheckTransaction = true>
  void SetType(ObjPtr<Class> type) REQUIRES_SHARED(Locks::mutator_lock_);

  template<bool kTransactionActive, bool kCheckTransaction = true>
  void SetAccessFlags(uint32_t access_flags) REQUIRES_SHARED(Locks::mutator_lock_) {
    SetField32<kTransactionActive, kCheckTransaction>(AccessFlagsOffset(), access_flags);
  }

  template<bool kTransactionActive, bool kCheckTransaction = true>
  void SetArtFieldIndex(uint32_t idx) REQUIRES_SHARED(Locks::mutator_lock_) {
    SetField32<kTransactionActive, kCheckTransaction>(ArtFieldIndexOffset(), idx);
  }

  template<bool kTransactionActive, bool kCheckTransaction = true>
  void SetOffset(uint32_t offset) REQUIRES_SHARED(Locks::mutator_lock_) {
    SetField32<kTransactionActive, kCheckTransaction>(OffsetOffset(), offset);
  }

  friend struct art::FieldOffsets;  // for verifying offset information
  DISALLOW_IMPLICIT_CONSTRUCTORS(Field);
};

}  // namespace mirror
}  // namespace art

#endif  // ART_RUNTIME_MIRROR_FIELD_H_