피어 검토를위한 XSD 체계 서식
https://stackoverflow.com/questions/202049
italiano
english
français
española
中国
日本の
العربية
Deutsch
한국어
Português
Russian문제
XSD 체계로 표시되는 데이터 모델을 설계했습니다. 데이터 모델은 또한 WSDL 디스크립터에서 웹 서비스 매개 변수로 사용되는 유형을 제공합니다.
XSD 체계를 보내고 관련된 사람들에게 동료 검토 데이터 모델을 검토하도록 요청하고 싶습니다.
어떤 도구 또는 프레젠테이션 방법을 동료 검토의 기초로 사용 하시겠습니까? 적어도 매개 변수의 의미 론적 의미에 관해서는 숙련되지 않은 사람들에게 데이터 모델을 읽을 수 있어야합니다.
편집하다:
보다 구체적으로 : 물론, 구문 적으로,이 체계는 검증됩니다. 실제로 나는 이미 JAXB 생성 클래스를 기반으로하는 코드를 연구하고 있습니다. 내 목표는
- 데이터 모델과 입력 매개 변수를 동결하려면
- 시맨틱 (비즈니스 관련)의 관점에서 아무것도 잃어 버리거나 잊혀진지 확인하기 위해.
편집 2
나는 데이터 모드를 퍼뜨리는 것이 가장 좋은 방법에 대해 생각해 왔습니다. XSD 스키마를위한 Javadoc과 같은 것을 생각하고 있습니다. 그런 것이 존재하는지 아는 사람이 있습니까? 기본적으로 XSLT 세트로 수행 될 것입니다.
다른 팁
추천합니다 사용 무언가를위한 XSD. 특히 예제를 실제 코드로 표시하는 실제 응용 프로그램을 표시하십시오.
실제 응용 프로그램은 스키마를 흥미롭게 만드는 것입니다. 예제는 크고 정교하거나 완전히 현실적 일 필요는 없습니다. 그들은 단지 컴파일해야합니다. 다른 사람들은 코드 샘플을 복사하여 붙여 넣기를 원할 것입니다.
이 예는 스키마의 "hello World"입니다. 그리고 그들은 스키마에 대한 일종의 단위 테스트 역할을합니다.
내가 본 XML 스키마를 위해 Javadoc과 가장 가까운 것은 스키마에서 생성 된 소스에서 Javadoc 도구를 실행하는 것입니다. 1) 스키마에 내부 주석 요소가 문서화되어 있고 2) 소스 생성기가 해당 주석을 Javadoc 요소로 사용합니다.
매우 유용한 산소 XML 개발자는 문서 생성을 지원합니다.http://www.oxygenxml.com/xml_schema_documentation.html(상업적이지만 완전히 기능적인 30 일 시험이 있습니다)
지금 시도해 보겠습니다. 모든 유형과 사용 가능한 XSD를 사용하여 문서를 생성하는 간단한 방법이 필요합니다. 간단한 인터페이스 설명으로 문서 설명 ...
** 공개 : 나는 아래에 언급 된 문서 도구의 제작자 인 Innovasys를 위해 일합니다. *
당신은 볼 수 있습니다 Innovasys 문서! 엑스. 모든 요소, 간단한 유형, 복잡한 유형, 그룹 및 속성 그룹에 대해 구조화되고 링크 된 페이지를 자동으로 생성 할뿐만 아니라 XSD 및 XSD 및 XSD 및 주석이 포함 된 구조 테이블도 생성됩니다. 스키마의 요소들 사이의 관계를 이해하십시오. 출력은 템플릿 기반이므로 선호하는 스타일과 구조에 적응할 수 있습니다. Web Ready HTML 또는 컴파일 된 도움말 파일에 대한 출력을 구축합니다.
독창적으로 여기에는 Wysiwyg 편집기가 포함되어있어 추가 컨텐츠를 작성하여 자동으로 생성 된 물건과 XSD 소스의 주석을 보완 할 수 있으므로 동료 검토를위한 추가 상황 정보를 제공 할 수 있습니다. 또한 생성 된 출력을 보는 사람들이 댓글과 피드백을 녹음 할 수 있으며 문서 내에서 직접보고 작업 할 수있는 커뮤니티 확장 기능도 있습니다! 엑스.
