code: public void bodyWillEnter (BodyObject body)
      {
          // create a new occupant info instance and insert it into our canonical table
          OccupantInfo info = body.createOccupantInfo(_plobj);
          _occInfo.put(info.getBodyOid(), info);
  
          _plobj.startTransaction();
          try {
              addOccupantInfo(body, info.clone());
          } finally {
              _plobj.commitTransaction();
          }
      }
docs: This is called to inform the manager that a body is on the way in. This is called at the
  very beginning of the entry process before the client is informed that it is allowed to
  enter. This will be followed by a call to {@link #bodyEntered} once all events relating to
  body entry have been processed.