The Daily WTF 日本語
フォロー
CodeSOD: 公私連携
開発者は、API の並行処理ハンドリングコード内に不一致を発見しました。ステータスプロパティのコメントには、誤用を防ぐためにプライベートであるべきだと記載されていました。しかし、プロパティの定義ではパブリックとして宣言されていました。このパブリックな定義により、外部のコンシューマーがステータスを変更できるようになり、コメントの意図と矛盾しています。著者は、API ユーザーにドキュメントを読み、パブリックメソッドの推奨されるプライバシーを遵守することを期待することの皮肉を強調しています。このような不一致は、特に並行処理 API において懸念されます。誤用とその結果としての混乱の可能性が強調されています。リスクにもかかわらず、コードはパブリックにアクセス可能なままであり、コメントのみが警告として機能しています。これは、ドキュメントと実装が乖離するという一般的な見落としを浮き彫りにしています。