1dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu/* 2dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Copyright 2008 CoreMedia AG, Hamburg 3dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 4dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Licensed under the Apache License, Version 2.0 (the License); 5dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * you may not use this file except in compliance with the License. 6dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * You may obtain a copy of the License at 7dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 8dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * http://www.apache.org/licenses/LICENSE-2.0 9dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 10dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Unless required by applicable law or agreed to in writing, software 11dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * distributed under the License is distributed on an AS IS BASIS, 12dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * See the License for the specific language governing permissions and 14dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * limitations under the License. 15dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 16dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 17dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhupackage com.coremedia.iso.boxes; 18dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 19dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport com.coremedia.iso.IsoFile; 20dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 21dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhuimport java.util.List; 22dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 23dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu/** 24dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Interface for all ISO boxes that may contain other boxes. 25dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 26dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhupublic interface ContainerBox extends Box { 27dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 28dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 29dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets all child boxes. May not return <code>null</code>. 30dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 31dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return an array of boxes, empty array in case of no children. 32dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 33dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu List<Box> getBoxes(); 34dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 35dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 36dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Sets all boxes and removes all previous child boxes. 37dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @param boxes the new list of children 38dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 39dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu void setBoxes(List<Box> boxes); 40dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 41dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 42dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets all child boxes of the given type. May not return <code>null</code>. 43dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 44dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @param clazz child box's type 45dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return an array of boxes, empty array in case of no children. 46dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 47dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu <T extends Box> List<T> getBoxes(Class<T> clazz); 48dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 49dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 50dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets all child boxes of the given type. May not return <code>null</code>. 51dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 52dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @param clazz child box's type 53dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @param recursive step down the tree 54dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return an array of boxes, empty array in case of no children. 55dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 56dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu <T extends Box> List<T> getBoxes(Class<T> clazz, boolean recursive); 57dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 58dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 59dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Gets the parent box. May be <code>null</code> in case of the 60dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * {@link com.coremedia.iso.IsoFile} itself. 61dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 62dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return a <code>ContainerBox</code> that contains <code>this</code> 63dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 64dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu ContainerBox getParent(); 65dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 66dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu /** 67dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * Returns the number of bytes from the start of the box to start of the first child. 68dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * 69dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu * @return offset of first child from box start 70dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu */ 71dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu long getNumOfBytesToFirstChild(); 72dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu 73dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu IsoFile getIsoFile(); 74dd9eb897ee7c7b507cbdcf80263bb4b5de6966bfTeng-Hui Zhu} 75